开发者文档

快速开始

将 key 替换为你的即可。Key 可在首页填写邮箱领取或找回，均只发送到该邮箱；请查收后填入管理区或付款区。兑换码用于给已有 Key 增加额度。接口地址见下面示例。

方式一 · Claude Code

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

export ANTHROPIC_BASE_URL=https://api.moss.online
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 = "https://api.moss.online/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 https://api.moss.online/v1

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

curl 冒烟

curl -s https://api.moss.online/v1/models \
  -H "Authorization: Bearer sk-你的key" | head -c 200

模型名

/v1/models 返回当前在服名单，写那里的名字最稳。工具默认带的 claude-* 名字也能用，服务端会映射到在服模型，命中映射时响应头 X-Relay-Model-Mapped 会写清「谁→谁」。映射是按当前在服模型挑的，不承诺与原名同款同参数。

错误码

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

限速与额度

• 额度按套餐与余额计，用完即停，不自动续费，超额返回 402。
• 速率有每分钟上限，按 key 计，分档可调，超限返回 429 并带 Retry-After。
• 并发超限先排队（约 30 秒），排不上才回 429 并带 Retry-After 与 X-Concurrency-Limit；各套餐并发数见 GET /v1/plans，当前上限见 GET /v1/quota 的 concurrency_limit。
• 请求体上限 16 MiB（含 chunked），超了回 413；URL 与请求头合计各控制在 16 KiB 以内，超长会先被边缘挡成 431 或 520。
• 自助查询用 GET /v1/key，返回余额、到期时间、限速余量、免费额度余量与当前倍率。
• 免费额度无需付费即可使用，每日次数有限，当前值见 /status 的 free_daily_requests。/status 公开段任何人都能读；钥匙池、支付腿、上一位访客这类内部字段只有带 X-Admin-Key 才返回。

计费

• 对外价按上游官方价乘倍率计算，倍率见 /v1/pricing，单位元每百万 token。
• 额度以官方价美元计：用哪个模型就按那个模型的官方价扣美元（例：同上 tokens，贵模型扣得多、便宜模型扣得少），缓存用量未单列计费，按上游响应中的输入用量统计；不能将上游公布的缓存价视为本站单独的结算价。
• 调价提前三天公告，历史价记入 变更日志。
• 套餐发放的是美元额度（$1.5 / $8.5 / $19），并发数见 GET /v1/plans；额度永久有效，Key 到期只停调用。

付款

当前用支付宝扫码付款：先填入 Key，在套餐里选一档并点「生成付款码」，再扫付款区显示的二维码。普通收款码需要手动填写本单金额，备注填写订单号；若链接支持预填，页面会明确提示。请核对后再付款，入账结果以本单查询为准。

订单付款期限为 15 分钟，普通收款码本身不会随订单到期失效，请勿向已过期订单继续付款。按页面金额付款，备注填写订单号；当前由人工核对到账后开通。漏填备注、金额不符或付款后订单过期，请保留付款凭证联系核对，不要重复付款。

• 可用付款方式以支付宝页面为准，请核对订单金额与备注。
• 已付款但页面仍未确认入账，请保留付款记录并把订单号发到 hi@moss.online。
• 确认入账后加额度，提供订单记录而非发票；退款条件见退款政策。
• 请保留付款记录，无需重复付款，也不要在邮件中发送完整 API Key。

退款与主体

• 未消耗余额七天内可退，已消耗部分按上游官方计费结算；额度永久有效。
• 经营者就是 Moss 本身，不挂公司抬头；部署在境外主机，无境内 ICP 备案号。
• 不开票。付款即完成，没有开票门槛与流程，需要凭证时用订单号与账本记录。
• 如你的项目需要，可索取出口 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. 会被限速吗

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

8. 退款怎么算

未消耗余额七天内可退，已消耗部分按剩余额度比例结算；额度永久有效。

9. 上游政策变了怎么办

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

10. 数据与日志如何处理

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

11. 能开票吗

目前不开发票。确认入账后可以下载订单信息记录，实际付款凭证以支付渠道交易记录为准。

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

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

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

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

变更日志

调价与下架均记于此。