使用文档

快速开始

三步拿到能用的 key，把 base_url 换掉就能跑。

账号与两把 key

一个账号有两把 key，各管一类模型，不能混用。

接入客户端

FreeRouter 提供 OpenAI 兼容接口，任何支持自定义 base_url 的工具都能直接用。

curl

curl -X POST https://freerouter.pro.nizelo.info/v1/chat/completions \
  -H "Authorization: Bearer sk-pro-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pro/deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Python（openai SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk-pro-你的key",
    base_url="https://freerouter.pro.nizelo.info/v1",
)

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

Node / TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-pro-你的key",
  baseURL: "https://freerouter.pro.nizelo.info/v1",
});

const resp = await client.chat.completions.create({
  model: "pro/deepseek-v4.1-flash",
  messages: [{ role: "user", content: "你好" }],
});

图形客户端（Cherry Studio / ChatBox / Cline / Cursor 等）

• 服务商类型选「OpenAI 兼容」或「自定义」；
• API 地址 / Base URL 填 https://freerouter.pro.nizelo.info/v1；
• API Key 填你的 fr- 或 sk-pro- key；
• 模型名手填（图形客户端一般不会自动拉到完整列表），如 pro/deepseek-v4.1-flash；
• 需要联网搜索、图片理解等能力的客户端，模型名用 全小写英文 + 数字，不要写中文别名。

模型名怎么写

付费旗舰模型统一加 pro/ 前缀，免费池模型统一加 fr/ 前缀。

付费旗舰模型（pro/，需 sk-pro- key）

免费池模型（fr/，用 fr- key）

• 模型名格式 fr/<平台>/<型号>，具体有哪些取决于你自己在工作台配置了哪些免费额度；
• 不知道填什么就用 auto —— FreeRouter 会按健康检查和优先级自动挑一个当前可用的；
• 当前实际可用模型以「工作台 → 免费模型池」里列出的为准（健康检查每 5 分钟跑一次）。

用量与额度

工作台看实时概况，用户中心看每一笔调用的明细。

计费口径

额度统一以 DeepSeek v4 flash 为计价基准；换成其他旗舰模型时按该模型的倍率折算消耗。倍率表在管理后台「模型倍率」里维护，当前对外换算保持 1:1。

当前活动与优惠

以下优惠可以叠加，具体截止时间以首页倒计时为准。

兑换码怎么用

拿到 RD-XXXX-XXXX-XXXX 形式的兑换码，两个入口都能兑。

1. 下单一键兑换：在首页「续杯套餐」点任意一档「立即续杯」。弹窗里有一块「有兑换码？」——粘贴兑换码点「兑换开通」，成功即自动激活并显示你的专属 key。
2. 工作台兑换：登录后进入「工作台」，在「有兑换码？」卡片里粘贴兑换码，点「兑换」。

兑换码一次性使用、抢码是原子操作（不会出现两个人同时兑同一张码）。已有 Pro key 的话会按续杯处理：沿用原有 key、额度叠加，不用重新配置客户端。

常见问题

返回 401，说 key 无效？

大概率是两把 key 用错了地方：调 pro/… 模型必须用 sk-pro- key，调 fr/… 必须用 fr- key。也可能在用户中心点过「重置」，旧 key 已失效。

返回 429？

额度用完了（或被限速）。看用户中心的剩余额度，需要就买一包续杯，或换成免费池 key 继续用。

返回 404 / model not found？

模型名写错了。付费模型要带 pro/ 前缀，注意中间是斜杠、全小写；不确定就用 auto 先跑通。

调用地址为什么是 http 不是 https？

网关目前以固定公网 IP + HTTP 直接提供服务，桌面客户端与服务端调用不受影响。域名和 TLS 在后续规划中。

能同时充多个账号 / 多开吗？

一个 IP 最多注册 2 个账号，超出会被拦。一个账号的额度可以在多台设备上共用同一把 key。

免费池里的模型显示不可用？

免费池的健康状态每 5 分钟巡检一次。上游限流、额度耗尽或 key 失效时会自动标为不可用并切换到下一个候选模型；用 auto 可以避开这个问题。

付款后 key 没出现？

支付成功后会自动激活（下弹窗会自动刷新，通常几秒内）。超过 5 分钟仍未激活，把订单号发给站长处理。

更多信息

• 产品介绍与定价 —— 能力说明、套餐与当前活动
• 工作台 —— 你的密钥、免费模型池、用量概况
• 用户中心 —— 密钥管理、Token 用量明细、订单、邀请返利
• 订阅、发票或批量兑换码问题：联系站长