计费、限额与排障
点数怎么算
按 token 计费，输入、缓存命中输入、输出三段分开计价，单位「点数 / 千 tokens」：
消耗点数 =（未命中缓存输入 ÷ 1000 × 输入单价
+ 命中缓存输入 ÷ 1000 × 缓存价
+ 输出 ÷ 1000 × 输出单价）× 计费倍率算个例子：某模型输入 0.01 点/千、缓存价 0.002 点/千、输出 0.03 点/千，一次对话输入 1200 tokens（其中 800 命中缓存）、输出 800 tokens：
(1200-800) ÷ 1000 × 0.01 = 0.004 未命中缓存输入
800 ÷ 1000 × 0.002 = 0.0016 命中缓存输入
800 ÷ 1000 × 0.03 = 0.024 输出
小计 = 0.0296 点 —— 若倍率为 1 倍，本次实扣 0.0296 点- 计费精确到 0.0001 点，并设有 0.0001 点的最小计费，避免产生完全免费的调用
- 缓存命中价：Claude Code、Cline 等编程工具每轮都会重发完整上下文，命中缓存的部分只按缓存价计（通常约为输入价的 2 折）；模型未单独配置缓存价时，该部分退回按输入单价计
- 调用前会做余额预检，点数不够会直接拒绝，不会产生欠费
- 调用失败不扣点；上游 4xx 错误同样不计费
- 响应头会回传
X-Credits-Charged（本次扣费）与X-Remaining-Credits（剩余点数）
计费倍率与抵扣顺序
公式里的计费倍率决定了最终扣多少点，它只作用于模型 API（中转站），不影响站内 AI 写作与生图：
| 身份 | 倍率 | 说明 |
|---|---|---|
| 已开通 Coding Plan / Agent Plan | 1 倍（基准价） | 套餐额度内按基准价抵扣；额度耗尽回落点数余额的部分按订阅超额倍率 ×1.2 |
| 未订阅 + 有生效倍率卡 | 按卡上倍率（倍率 ×2~×9） | 每日签到抽中，有效期内生效 |
| 未订阅 + 无倍率卡 | 平台默认倍率（当前 ×10） | 默认倍率较高，签到或订阅可降低 |
扣费顺序（两步，均按当时生效的倍率计价）：
- 先抵扣套餐额度（Coding Plan / Agent Plan 的额度池，按 1 倍基准价）
- 额度/护栏用尽后，剩余部分扣点数余额，按订阅超额倍率 ×1.2计费；余额也不足才会返回 402
也就是说：订阅用户在套餐额度内始终按 1 倍计费；额度用尽后仍可继续调用（回落点数余额），只是超出部分按超额倍率结算——仍远低于未订阅的默认倍率。
倍率卡规则（每日签到 抽中的权益）：
- 有效期默认 1 天，到期自动失效、恢复默认倍率
- 同时持有多张时取最低倍率（对用户最有利）
- 中奖后立即生效，无需重启客户端或换密钥
- 只影响模型 API；同一账号下所有密钥共享同一个倍率
限免额度与订阅护栏
除了点数余额与密钥限额，还有两层「额度」会影响能否调用：
- 限免模型的每日免费额度：所有限免模型共用一份按账号计的日额度，每天需手动领取；领取后额度内 0 扣费，超出后按超量价（未配置超量价的模型直接拒绝）。未领取时不享受免费额度，但订阅在期或有 AI 点数余额的用户仍可正常调用（按模型正常价计费）。见限免模型与每日免费额度。
- 订阅额度池与固定周期护栏：Coding Plan / Agent Plan 除本期总额度外，还有 5 小时与每周的固定窗口上限，到点整段重置。见Coding Plan 与 Agent Plan。
| 情况 | 表现 | 处理 |
|---|---|---|
| 未领取今日免费额度（订阅在期 / 有点数余额） | 正常返回，按模型正常价计费 | 无需处理；想省钱就去「额度与卡片」领取今日额度 |
| 未领取今日免费额度（非订阅且无点数余额） | 403 free_quota_unclaimed | 先去「额度与卡片」领取今日额度 |
| 账号命中限免风控 | 403 free_quota_risk_blocked | 注册风控不可领；同 IP 多账号风控标记后累计充值 ¥1 可自动解除 |
| 限免额度用尽（模型无超量价） | 429 free_quota_exceeded | 换模型 / 等次日 0 点重新领取 / 用额度重置卡 |
| 限免额度用尽（模型有超量价） | 正常返回，超出部分按超量价计费 | 无需处理，注意单价变高 |
| 订阅额度用尽 | 自动回落点数余额，仍按 1 倍计费 | 无需处理 |
| 点数余额也不足 | 402 insufficient_credits | 充值点数或降低用量 |
密钥的五种限额
创建密钥时可在「高级选项」里设置，全部选填，留空表示不限制：
| 限额 | 作用 | 超限表现 |
|---|---|---|
| 每分钟请求数 | 防刷、控速 | 429 rate_limit_exceeded |
| 最大并发数 | 控制在途请求 | 429 concurrency_exceeded |
| 每分钟 token 数 | 控制 TPM 吞吐 | 429 tpm_exceeded |
| 额度上限 | 该密钥最多能用多少点 | 402 key_quota_exceeded |
| 有效期 | 到点自动失效 | 401 invalid_api_key |
还可以给密钥限定允许访问的模型，访问白名单外的模型会返回 403。
特供模型：按日历自动上下架
有些模型被标记为特供，按官方节假日日历自动开放，无需任何人手工上下架：
| 角标 | 开放时间 | 休市时间 |
|---|---|---|
| 💼 工作日特供 | 周一至周五 | 周末、法定节假日 |
| 🌙 假日特供 | 周末 + 法定节假日 | 工作日 |
判定依据是国务院办公厅年度节假日安排（含调休上班日）：调休上班的周末按工作日算，法定节假日连休中的工作日按假日算。每年新安排公布后平台会更新日历。
- 休市时：模型从
GET /v1/models列表消失，直接调用会返回 404model_not_found，错误信息里带预计重新上架时间（如「预计 9月28日(周一) 00:00 重新上架」） - 控制台：「模型API」页会置灰休市模型，并在「上架预告」里标注回归时间；在架的特供模型带角标正常使用，计费与普通模型一致
- 跨零点自动切换：特供状态在当天 00:00 生效，正在运行的长任务不受影响（休市只拦新请求）
调用热力图：一眼看全年用量
控制台「模型API」页的「我的密钥」页签里有张全年调用热力图（与概览页「登录活跃」同款交互）：一列一周、一格一天，颜色越热代表当天 token 消耗越大：
| 颜色 | 当日 token 消耗 |
|---|---|
| ⬜ 无调用 | 0 |
| 🟩 浅绿 | ≤ 100 万 |
| 🟩 绿 | ≤ 1000 万 |
| 🟧 橙 | ≤ 1 亿 |
| 🟥 红 | > 1 亿 |
- 悬浮任意格子可看当天的调用次数与准确 token 数
- 卡片上方统计全年调用天数、累计 tokens、单日峰值与总调用次数，右上角可切换年份回看
错误码对照表
| 状态码 | 错误码 | 含义与处理 |
|---|---|---|
| 400 | — | 请求缺少 model 参数或参数不合法 |
| 401 | invalid_api_key | 密钥无效、被吊销、已过期，或账号被停用。新建一个密钥试试 |
| 402 | insufficient_credits | AI 点数余额不足，去 AI 点数 充值或购买 |
| 402 | key_quota_exceeded | 该密钥的额度上限用完了，新建密钥或调高上限 |
| 403 | model_not_allowed | 该密钥不允许访问此模型，检查密钥的模型白名单 |
| 404 | model_not_found | 模型名不存在、未上架，或为特供模型休市中（错误信息会注明上架时间），核对控制台的模型列表与特供说明 |
| 429 | rate_limit_exceeded | 请求太频繁，等提示的秒数后重试 |
| 429 | concurrency_exceeded | 并发达上限，减少同时在途请求 |
| 429 | tpm_exceeded | 每分钟 token 达上限，放慢速度 |
| 403 | free_quota_unclaimed | 今日免费额度尚未领取，且账号既非订阅、也无 AI 点数余额。去控制台「模型 API → 额度与卡片」领取后再调用 |
| 429 | free_quota_exceeded | 今日限免额度已用尽（该模型无超量价）。响应头 Retry-After 为距次日 0 点的秒数，不必重试 |
| 502 | upstream_error | 上游厂商返回错误，稍后重试 |
| 503 | no_upstream | 该模型暂无可用渠道，换个模型或稍后再试 |
{"error":{"message":"...","type":"...","code":"..."}}；即便你用 Anthropic 协议（/v1/messages）调用，错误体也会转换成 Anthropic 的 {"type":"error","error":{...}} 形态，Claude Code 与官方 SDK 都能正确解析。排查思路
- 401：OpenAI 协议确认请求头是
Authorization: Bearer sk-relay-...（Bearer后有空格）；Anthropic 协议确认用的是x-api-key: sk-relay-...且带了anthropic-version - 404：模型名大小写要和控制台一致，不要凭记忆填写
- 402：分清是「钱包余额不足」还是「密钥额度用完」，两者的
code不同 - 账单比预期高：先看该次调用的倍率——未订阅且没有倍率卡时按平台默认倍率（当前 ×10）计费；开通订阅或签到抽卡都能降下来
- 429：降低频率或提高密钥限额，客户端建议加指数退避重试
- 响应慢：查看调用记录里的耗时分布，也可能是上游厂商拥塞
常见问题
可以多个设备共用一个密钥吗？ 可以，但共用会叠加限额。建议一个设备或应用一个密钥，方便分别限流和吊销。
密钥泄露了怎么办？ 立即在控制台吊销该密钥，泄露的密钥会马上失效，然后新建一个替换。
账单和调用记录能对上吗？ 控制台「调用记录」里有每一条的 token 数、使用的倍率与实扣点数；钱包流水中类型为「模型API调用」的记录与之对应。
为什么开通套餐后账单还是偏高？ 套餐额度按 1 倍基准价抵扣，额度用尽后回落点数余额也仍是 1 倍。若账单偏高，请确认订阅状态是否已生效（下单后需完成支付）。
倍率卡生效了，为什么账单没变化？ 倍率卡只影响中奖之后发起的调用，已经发生的调用不会追溯调整；另外它与套餐额度无关，仅对「回落点数余额」的部分生效。
为什么调用返回 403 free_quota_unclaimed？
今天还没领取免费额度，且账号既没有生效中的订阅、也没有 AI 点数余额。去控制台「模型 API → 额度与卡片」点「立即领取今日额度」，领取后额度内 0 扣费。订阅在期或有余额的账号不会遇到这个错误——未领取时按模型正常价继续计费。详见限免模型与每日免费额度。
为什么调用返回 429 free_quota_exceeded？
该模型属于限免模型、今日已领取的额度已用尽，且它没有配置超量价。等次日 0 点重新领取，或换用非限免模型；当天还想继续用，可以用一张额度重置卡把当日计数清零（需先领取今日额度）。详见限免模型与每日免费额度。
订阅了 Coding Plan，为什么还是提示余额不足？
订阅提供的是额度池：额度用尽后会回落点数余额，余额也不足才会返回 402。402 文案会写明具体原因：本期额度用完（需续费进入下一期）、5 小时护栏触顶（文案里带下次重置的精确时刻，每 5 小时整段重置）或周护栏触顶（同样带精确时刻，每满 7 天整段恢复满额）。急用可先充值点数余额应急，护栏到点会自动恢复，无需联系客服。