开发者文档

快速开始

将 key 替换为你的即可。key 可在首页自助领取，免费额度无需邮箱；也可用兑换码兑换。

方式一 · Claude Code

两个环境变量，key 换成你的；块右上角可一键复制。

export ANTHROPIC_BASE_URL=http://127.0.0.1:8788
export ANTHROPIC_AUTH_TOKEN=sk-你的key
claude -p "hello"

方式二 · Codex CLI

写进 ~/.codex/config.toml。

# ~/.codex/config.toml
model_provider = "relay"
[model_providers.relay]
name = "Relay"
base_url = "http://127.0.0.1:8788/v1"
env_key  = "RELAY_API_KEY"
wire_api = "chat"
requires_openai_auth = false

方式三 · 其它 OpenAI 兼容客户端

任何支持自定义 base_url 的客户端都可用这一组。

Settings → Models
  OpenAI API Key    sk-你的key
  Override Base URL http://127.0.0.1:8788/v1

Cursor 的自定义 key 仅对 chat 模型生效，Tab 补全仍走其自带通道。另提供 ps1 与 sh 各一份一键配置脚本。

curl 冒烟

curl -s http://127.0.0.1:8788/v1/models \
  -H "Authorization: Bearer sk-你的key" | head -c 200

错误码

错误语义对齐 OpenRouter 公开规范，错误体形如 {"error":{"type":…,"code":…,"message":…}}。

限速与额度

• 额度按套餐与余额计，用完即停，不自动续费，超额返回 402。
• 速率默认每分钟 60 次，按 key 计，分档可调，超限返回 429 并带 Retry-After。
• 并发超限先排队（约 30 秒），排不上才回 429 并带 Retry-After 与 X-Concurrency-Limit；各套餐并发数见 GET /v1/plans，当前上限见 GET /v1/quota 的 concurrency_limit。
• 自助查询用 GET /v1/key，返回余额、到期时间、限速余量、免费额度余量与当前倍率。
• 免费额度无需付费即可使用，每日次数有限，当前值见 /status 的 free_daily_requests。

计费

• 对外价按上游官方价乘倍率计算，倍率见 /v1/pricing，单位元每百万 token。
• 额度以官方价美元计：用哪个模型就按那个模型的官方价扣美元（例：同上 tokens，贵模型扣得多、便宜模型扣得少），缓存读（cache read）当前按上游口径不计费 ⇒ 实际比价目表更便宜；后续按上游缓存价接线。
• 调价提前三天公告，历史价记入 变更日志。
• 套餐发放的是美元额度（$2 / $6.5 / $15），并发数见 GET /v1/plans；到期未用完可结转一个月。

付款

个人收款码，三步完成，无需沟通。

• 先在首页取一把 key（免费额度足够跑通）。
• 取订单号（推荐）：POST /v1/order（带你的 key），body 如 {"plan":"month59"}，返回 {"code":"SQ-XXXX","amount_cny":59,…}。
• 按档位金额转账（10 / 59 / 129），备注填订单号（对外只宣传这一法）。
• 老账户也可只写 key 后六位：后台兜底，且**只有全账户唯一才认**（撞尾不认）。
• 到账后自动加到该 key（无回调，靠邮箱到账提醒识别）；金额不符时人工核对，无需催办。
• 备注是唯一到账凭据；同一笔只加一次（两法都幂等）。

退款与主体

• 未消耗余额七天内可退，已消耗部分按上游官方计费结算；到期未用完可结转一个月。
• 个人主体；按现方案部署在境外主机，故无境内 ICP 备案号，不等备案即可上线。
• 发票可选，无开票门槛、充值即开；普票默认，专票按 1%，需提供税号。当月 25 日前提交，次月出票，全电子可下载验签。
• 如你的项目需要，可索取出口 IP 与域名、调用日志、发票与主体信息（上线后提供）。

FAQ

1. 你们是官方吗，能填 GPT / Claude 的名字吗

不是。本站是通道：OpenAI 与 Anthropic 两套协议都接，官方模型名可直接填，会映射到价目表里的在服模型。

2. 国内直连可用吗

可用；由服务器统一出网，本地不需要代理。

3. 官方可用地区不含大陆，为什么本站能跑

这两家 API 的可用地区不含大陆与香港，从香港出口会 403；本站由境外主机出网调用。

4. 会不会偷改倍率

不会。倍率固定，调价提前三天公告，历史价留档。

5. 会改我的请求吗

不会。User-Agent、anthropic-beta、x-app、x-stainless-* 原样透传，这也是 Claude Code 能被上游正确识别的条件。

6. 怎么判断一家中转是否可靠

社区常见四类问题，本站对应做法如下。

7. 会被限速吗

会。默认每分钟 60 次，免费额度另有每日上限，超限返回 429 并带 Retry-After。

8. 退款怎么算

未消耗余额七天内可退，已消耗部分按剩余额度比例结算；到期未用完结转一个月。

9. 上游政策变了怎么办

先公告再调整。受影响的模型需改道或限速均提前说明，不静默降级，也不静默下架。

10. 数据与日志如何处理

保留逐请求账本，用于对账与排查。不二次审核内容，也不向请求中注入内容。

11. 能开票吗，支持对公吗

个人可开票，对公可谈。无门槛，充值即可开；当月 25 日前提交，次月出票。企业提供名称与统一社会信用代码，个人提供姓名与身份证号，另附金额与票种。全电子，PDF 或 OFD 可下载验签。

12. 有备案号吗，我自己要备案怎么办

没有。按现方案部署在境外主机，本站不等备案即可上线。你的网站或应用按你的主体自行办理；若用境内服务器，另行办理公安联网备案。需要材料时找我们索取，接口日志、出口信息、发票与主体信息都可现成提供。

13. 名字含 Claude 与 GPT，算官方吗

不算。上游名称仅用于描述兼容与运行，不进本站产品名，也不暗示背书。

变更日志

调价与下架均记于此。