使用文档

快速开始

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

账号与两把 key

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

接入客户端

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

curl

curl -X POST https://freerouter.markwave.top/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.markwave.top/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.markwave.top/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.markwave.top/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 分钟跑一次）。

用量与额度

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

计费口径（2026-09-15 起：完全按上游规则）

计费单价直接照搬上游官方价目（TokenRhythm 目录），逐模型三项：输入价、输出价、缓存命中读价。不加价、不折算倍率。每一次调用单独计费：

命中缓存的输入不再免费：按上游的缓存读价计费（约为该模型输入价的 2%~29%，各模型不同，见下表）。上游就是按这个价向我们收费的，我们按同一个价计费。

在用户中心「Token 用量」里，表格每一行就是一次请求：本轮新增输入是本次真正新发的输入（按输入价），缓存命中输入是其中被上游缓存命中的部分（按缓存读价），两者相加才是本次总输入；输出 TOKENS 按输出价计入额度。

单价表（¥ / 百万 token，上游官方价，随上游调价同步）

缓存命中一列为 0 的模型 = 上游没给缓存折扣价，命中部分不额外收费。完整 21 个付费模型的价目以上游官方目录为准。

当前活动与优惠

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

续杯额度有效期

2026-09-24 00:00（CST）起新购的续杯包启用 30 天有效期。

为什么要有有效期

续杯套餐的定位是「主力额度不够用时，用来顶一下项目推进」的补充包，不是囤货用的长期库存。所以从 2026-09-24 00:00 起，新购额度有效期统一为 30 天，并在到期前 7 / 3 / 1 天提醒你 —— 希望你按项目节奏买、尽量多用快用：用完不够再买，比囤着更划算。

有效期怎么算

• 从下单成功那一刻起算 30 个自然日，与你什么时候开始调用无关；
• 续杯（再买一包）时，到期日取「原到期日」与「续杯日 + 30 天」中较晚的那个 —— 手上老额度的有效期不会被缩短；
• 账号里只有一把 Pro key、一个额度池，所以「优先消耗老额度」在实现上就是：老额度绝不会因为这次调整提前失效，建议先用完手上的老额度再续杯。

到期会怎样

到期后额度清零、该 key 整体失效，接口返回 401（英文提示 Authentication Error - Expired Key）。这不是故障，也不是封号 —— 重新购买一包即可继续使用，已消耗的额度不会补回，也不会自动续杯。

谁不受影响

2026-09-23 23:59 之前已购买的额度，有效期不变（多数为购买日起 1 年），并且优先消耗。本次调整不追溯已完成的购买。

兑换码怎么用

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

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

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

常见问题

返回 401，说 key 无效？

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

返回 429？

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

额度到期了怎么办？

2026-09-24 00:00 起新购的续杯包额度有效期 30 天，到期后该 key 会失效、接口返回 401（英文提示 Expired Key）。这不是故障，也不是封号 —— 重新购买一包即可继续使用，已消耗的额度不会补回。到期前 7 / 3 / 1 天我们会提前提醒。

有效期从哪天开始算？

从下单成功的时间起算 30 天，与你什么时候开始用无关。续杯时到期日取「原到期日」与「续杯日 + 30 天」中较晚的那个，所以老额度不会被缩短。2026-09-23 23:59 前已购买的额度按购买时的规则执行，不受本次调整影响。

为什么改成 30 天？以前不是能用很久吗？

续杯包是「主力额度不够时顶一下项目推进」的补充包，不是长期库存。改成 30 天 + 到期前 7 / 3 / 1 天提醒，是为了让你按项目节奏购买、把额度用在你真正在推进的事情上 —— 多用、快用，比囤着更划算。

计费单价是谁定的？

直接照搬上游官方价目（TokenRhythm 目录），逐模型三项：输入价、输出价、缓存命中读价；不加价、不折算倍率。上游调价后价目同步更新，以本页「计费口径」的单价表为准。

命中缓存为什么也要计费？

因为上游就是这么收我们的：上游对命中缓存的输入按「缓存读价」（约为输入价的 2%~29%）收费。2026-09-15 起我们的计费口径完全对齐上游，同一个价转给用户，不再免费。用户中心「Token 用量」里 本轮新增输入 与 缓存命中输入 分两列列出，可以逐笔核对。

返回 404 / model not found？

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

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

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

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

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

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

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

付款后 key 没出现？

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

使用本服务有什么限制？

仅限合法用途：未经授权的渗透测试、漏洞扫描、口令爆破、攻击等一律禁止。详见下一节「使用条款与禁止用途」。一经核实，立即停止服务且不退还任何费用。

使用条款与禁止用途

注册、下单或继续使用本服务，即视为已阅读并同意本节内容。

本服务只提供模型 API 转发，仅限合法用途。明确禁止：

• 将本服务用于未经授权的渗透测试、漏洞扫描、口令爆破、拒绝服务攻击等任何攻击行为；
• 将本服务用于生成、传播违法违规内容，或从事其他违反服务所在地法律法规的活动；
• 将 key 转售、共享、出借给他人用于上述用途。

安全测试类能力请在已获得目标系统所有者明确授权的前提下使用。一经核实存在上述行为，我们有权立即停止服务且不退还任何费用，并在收到有权机关要求时保全并配合提供相关访问记录。

虚拟商品有效期

自 2026-09-24 00:00（CST）起售出的续杯包，额度有效期为自下单成功起 30 个自然日；到期未使用的额度自动失效，不予退还或折现。本条款不溯及 2026-09-23 23:59 前已完成的购买，其额度有效期按原规则执行并优先消耗。我们将在到期前 7 天、3 天、1 天通过注册邮箱提醒。

更多信息

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