Claude 中转服务计费 FAQ:预扣、退款、试用额度、用量怎么查

用 api 中转调用 Claude,最常被问到的不是"支不支持某个模型",而是"这笔钱到底是怎么算的"。预扣和最终扣费为什么会不一样?调用失败了钱去哪了?试用额度是自动到账还是要申请?用量日志能不能导出去对账?

这篇 FAQ 把这几类问题按实际计费流程捋一遍,每条都对应一个可以自己验证的机制,不涉及任何具体价格数字——价格实时变化,一律以 /pricing 上的表格为准。

Claude 中转计费的三段式:预扣 → 结算 → 退款

请求发出的一瞬间,钱扣在哪一步?

一次调用的计费分三步,不是"调用完再扣一次款"这么简单:

1. 预扣(pre-hold):请求刚发出、结果还没返回时,系统会按一个估算值先在账户余额里"占用"一部分额度。这一步发生在请求真正打到上游模型之前。
2. 结算(settle):上游返回结果后,系统按模型实际返回的 token 用量重新计算真实费用,用真实费用去顶替之前的预扣金额——多退少补,不会让预扣的估算值成为最终账单。
3. 退款(refund):如果这次调用最终失败(比如上游返回 5xx),预扣的额度会自动全额退回,不计费。

这三步是 Claude 中转计费的核心逻辑,也是为什么"账单金额"和"你实际收到的回复内容"能对得上——账单不是按请求次数收费,而是按真实 token 用量结算的。

为什么预扣金额和最终账单金额不一样?

预扣阶段还不知道模型这次到底会吐多少 token,所以是按估算值先占位,主要作用是防止余额在并发请求下被超支。等真正的 completion tokens 数量确定,系统会用真实用量重新计算,预扣值只是过程量,不是最终账单。如果你在 Playground 或用量日志里看到"预扣中"的状态,过几秒刷新一般就会变成结算后的真实金额。

一次调用要收几次钱?

不会。一次请求只对应一次最终计费(或一次退款),预扣不是额外收费,只是记账时序上的中间态。

什么情况会自动退款?

上游报错也要付钱吗?

不需要。如果调用因为上游故障(网关重试之后仍然失败)而没有拿到有效结果,这次请求不计费——预扣的额度会自动退回账户,不需要手动申请。这个逻辑对所有渠道路由到的模型一视同仁,不区分具体供应商。

限流(429)算不算失败要退款?

限流响应本身不产生扣费,因为请求根本没有被计费的结果返回。收到 429 通常意味着短时间内请求过于密集,建议做指数退避后重试,而不是立刻重发。

我自己代码写错了(比如模型 id 拼错)会扣钱吗?

不会。请求参数错误(比如 404 模型不存在、401 key 无效)在到达计费结算这一步之前就会被拦下,不会产生实际扣费。

下面是一张常见错误码和对应处理方式的速查表,排错的时候可以直接照着查:

| Status | 原因 | 处理方式 | |---|---|---| | 401 | API key 缺失或无效 | 检查 Authorization 请求头,确认 key 没有被吊销 | | 402 / 403 | 账户余额不足 | 去控制台的 Billing 页面充值 | | 404 | 模型 id 不存在,或不在这把 key 的白名单里 | 核对 /models 目录里的真实 id | | 429 | 触发限流 | 指数退避后重试 | | 5xx | 上游渠道故障 | 网关会自动跨渠道重试;最终仍失败则不计费,预扣自动退款 |

Claude 中转服务的试用额度怎么领

需要绑卡才能拿到试用额度吗?

不需要。新账户注册后会自动获得一笔试用额度,直接计入账户余额,不需要提交支付方式,也不需要单独申请或联系客服。

试用额度能用来调用哪些模型?

试用额度进的是同一个账户余额,和付费充值的额度没有区别——目录里任意模型都可以用它调用,不存在"试用额度只能用某几个模型"的限制。

试用额度会不会突然消失,或者过期?

账户余额本身不设过期时间,试用额度进账后和普通余额一样长期有效,不会因为放着不用而被清零。具体到账金额以注册当时页面展示的数字为准——展示口径和实际发放口径是同一套逻辑,不存在"页面写的比实际到账多"这种情况。

用量数据在哪查?CSV 怎么导出?

想知道每次调用花了多少钱,去哪看?

控制台的 Usage 页面记录了每一条调用的明细,包括:调用了哪个模型、prompt/completion 各自的 token 数、耗时、是不是流式请求、以及这次实际扣了多少钱。日志还区分了几种类型——正常调用(Call)、充值(Top-up)、退款(Refund)、报错(Error)等,方便按类型筛选,不用在一堆流水里人工分辨。

单笔调用的费用精确到几位小数?

单笔成本精确到小数点后 6 位。这个精度是为了让极小额的单次调用也能在日志里对得上账,而不是被四舍五入到看不出差异。

想导出账单去核对,支持吗?

支持,Usage 页面可以按时间范围筛选后导出 CSV,单次导出最多 1,000 行。如果调用量特别大,建议按时间段分批导出。

想在代码里拿到这次调用消耗了多少 token,而不是去控制台看,怎么办?

如果用的是流式(streaming)请求,在 payload 里加上 stream_options.include_usage,最后一个 chunk 会带上真实的 token 用量——这正是计费所用的那份数字,和账单口径一致。一个典型的非流式请求长这样({GATEWAY_BASE_URL} 替换成你的部署实际网关地址):

curl {GATEWAY_BASE_URL}/chat/completions \
  -H "Authorization: Bearer $APIKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

请求走的是标准的 OpenAI 兼容协议,model 字段填目录里的真实模型 id 即可,不需要针对 Claude 系列单独换一套请求格式。具体可用的模型 id 以 /models 页面为准。

小结

Claude 中转计费的核心就是三句话:先按估算预扣,再按真实用量结算,失败自动退款。账户余额不设最低消费,不需要订阅,一份余额打通目录里所有模型;用量明细和 CSV 导出让每一笔扣费都可以自己核对,不需要靠信任。

如果还没试过,注册账户会自动拿到一笔试用额度,不需要绑卡就能先跑几次真实调用看看账单是不是和预期一致;想直接看实时单价,去 /pricing 就有完整的价格表。准备好接入的话,可以从 /sign-up 开始。