接入文档

从注册到第一条请求约 3 分钟。本文所有示例均可直接复制运行。

Base URL：https://freesharenow.com/v1（备用域名 https://freeshare.cc.cd/v1）
同时兼容 OpenAI Chat Completions 与 Anthropic Messages 两套协议。

1. 注册与密钥

打开注册页，用 GitHub / Google / LinuxDO 登录（无需设置密码）。
进入控制台 →「令牌」→ 新建令牌，得到 sk-... 开头的密钥。
按下节贡献一个上游 Key 或授权 Qoder，获得每日额度后即可调用。

新账号默认额度为 0，必须先完成第 2 节的贡献（或充值钱包）才能发出请求。

2. 获取每日额度（贡献上游 Key）

平台额度来自用户贡献的上游 Key。当前开放两家，每家各 $20/天，可叠加：

供应商	贡献方式	每日额度
商汤 SenseNova	到 platform.sensenova.cn 创建 API Key，在控制台「贡献上游 Key」粘贴提交	$20/天
Qoder	控制台「贡献上游 Key」→ 选择 Qoder → 按提示完成设备码授权（无需填 Key）	$20/天

系统会立即验活；通过后额度当天生效，每日 00:00（北京时间）自动重置。

邀请奖励

邀请 1 位好友注册即 +$5/天 订阅额度，单账号最高 +$20/天（4 人封顶），与贡献额度叠加。邀请链接在控制台「个人设置 → 邀请信息」复制。好友被封禁或注销后，对应奖励自动回收。

3. 第一次调用

curl

curl https://freesharenow.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    base_url="https://freesharenow.com/v1",
    api_key="sk-你的密钥",
)

resp = client.chat.completions.create(
    model="deepseek-v4.1-flash",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Anthropic 协议（Claude Code 等）

export ANTHROPIC_BASE_URL="https://freesharenow.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
# 之后按 Claude Code 正常使用即可，模型名填 glm-5.3-flash / kimi-k3 等

4. 客户端配置

客户端	填法
Cherry Studio / ChatBox / NextChat	服务商选「OpenAI」，API 地址 `https://freesharenow.com/v1`，模型填下方表格里的裸名
Cursor	Settings → Models → OpenAI API Key 填密钥，Override Base URL 填 `https://freesharenow.com/v1`
Claude Code	按第 3 节设置 `ANTHROPIC_BASE_URL` 与 `ANTHROPIC_AUTH_TOKEN`
Cline / Roo Code	API Provider 选 OpenAI Compatible，Base URL 同上

5. 可用模型

下表实时取自线上可用性快照，维护中表示该模型此刻暂无可用上游。

模型	接口标识	上下文	调用端点	分组	状态
加载中…

6. 额度与计费

订阅额度：贡献 Key 获得，每日 00:00（北京时间）重置，不累积。
钱包余额：充值获得，用于 VIP 专线模型；订阅额度耗尽后不会自动扣钱包（除模型允许回退）。
计费按实际输入 / 输出 Token；具体单价见首页模型与定价。

7. 常见错误码

状态码	含义	处理方式
401	密钥无效	确认密钥以 `sk-` 开头、未删除、未过期；`Authorization: Bearer sk-...`
403	额度不足	当日订阅额度用尽（次日 00:00 重置），或贡献的上游 Key 已失效，需重新提交
429	上游限流/排队	上游账号 TPM/RPM 打满或模型排队，等 30 秒重试，或换同类模型
503	该模型暂无可用渠道	模型当前无在线上游，换模型或稍后重试；首页状态会实时反映

8. 常见问题

Base URL 要带 /v1 吗？

要。填 https://freesharenow.com/v1，不要填到 /chat/completions。

为什么返回的 model 名称和我请求的不一样？

上游可能回写自己的模型名，属正常现象，按响应内容使用即可。

会记录我的对话内容吗？

平台仅在请求日志中记录模型、Token 数与耗时等计量字段用于额度结算，不存储对话正文。详见隐私政策。

支持并发吗？

支持，但上游按账号限流；高并发场景建议使用 VIP 专线模型。