AI API 中转站为什么会空回复扣费？如何判断扣费是否透明

什么是预扣费 + 最终结算

大多数 AI API 中转站（包括 New API / One API 架构）采用两阶段计费：

1. 预扣费阶段：发起请求时，根据预估 token 数扣除费用
2. 最终结算阶段：请求完成后，根据实际 token 消耗多退少补

问题出在第二步：如果请求失败或没有有效输出，预扣费可能不会返还。

为什么页面余额看不出小额扣费

页面余额经过了两层处理：

• 预扣：发起请求时扣除
• 结算：请求完成后根据实际消耗调整

如果大量小额失败请求累积（比如每笔 0.001 元），余额页面可能只显示"掉了 10 元"，但用户不知道这 10 元是由 10000 笔失败请求组成的。

raw quota 为什么更准确

raw quota 是请求前后 quota 的实际差值，代表真实 token 消耗。通过 /api/user/self 接口可以获取：

• quota：预扣后余额（经过结算的）
• raw_quota：真实 quota（预扣前的原始值）
• quota_per_unit：每单位的价格

对比这两个值，可以判断：

• 如果 raw_quota 和 quota 一致 → 正常
• 如果 quota 明显低于 raw_quota 差值 → 可能在返还预扣费
• 如果请求失败但 quota 或 raw quota 有变化 → 需要结合 request_id、usage、completion_tokens、stream 状态、tool_call / 图片 / 音频 / 搜索等其他计费项综合判断

失败请求是否应该扣费

常见场景怎么查

空回复是否应该扣费

completion_tokens=0 的空回复需要分情况判断：

• prompt 本身无法生成有效回复：用户问题，无法生成有效内容，扣费可能是合理的
• 服务端处理错误（503/524）：中转站或上游问题，不应让用户承担预扣费
• 渠道质量导致输出被截断：中转站配置问题，应该返还
• max_tokens 设置过低：用户配置问题，扣费可能合理

503 / 524 是否应该扣费

• 503 Service Unavailable：上游服务不可用，请求未实际处理。理想情况下完全不扣费。
• 524 Gateway Timeout：Cloudflare 超时，上游可能处理了一部分。需要看实际消耗。

Claude Code 524 / 503 超时会不会扣费？

超时不等于一定扣费，也不等于一定没扣费。判断时要看请求是否到达上游、是否产生 usage/raw quota、是否有 completion_tokens，以及中转站是否记录了错误明细。

Claude Code 的 524/503 超时场景有特殊性：

• 524 更常见于长请求、代理层或源站响应超时——请求可能已发出但上游响应太慢，代理层在规定时间内没有收到响应
• 503 更常见于上游渠道不可用、路由失败、余额或权限问题——请求到达了网关但上游无法处理

什么情况下不应该扣费

• 如果 completion_tokens=0、没有有效文本、没有 tool_call、image、audio、search 产物，不应按成功输出最终扣费
• 如果已经预扣，应在最终结算阶段返还
• 524 场景下请求未到达上游（无 request_id），理论上不应有成功扣费记录

什么情况下可能扣了费

• 请求已到达上游，上游实际处理了部分 prompt（产生了 usage 记录）
• 上游返回错误但计费系统记录为"已完成"
• 多跳链路中某段产生了中间成本

建议配合以下页面进行排查：

• Claude Code 524 / 503 排查：/claude-code-524-503-timeout/
• tool_call message 排查：/tool-call-message-api-error/
• 空回复 / empty response：优先结合 completion_tokens、usage、raw quota 和消费记录综合判断
• API Gateway 机制：/openai-compatible-api-gateway/
• Claude API 渠道选择：Claude API 渠道选择指南（Claude Code 长请求失败、empty response 或 client_gone 场景可结合一起排查）

如何辅助核查扣费记录

可以结合以下方式辅助判断扣费是否需要进一步排查：

1. 对比请求前后的 quota 差值，参考 /api/user/self 返回的 quota 和 raw_quota
2. 检查 request_id、usage、stream 状态和 completion_tokens
3. 确认是否有 tool_call、图片、音频或搜索等其他计费项
4. 结合后台消费记录和结算明细综合判断

你也可以使用 AI API Doctor 辅助检查 Base URL、API Key、模型权限和常见错误，结合后台 usage、raw quota 与消费记录进行辅助核查。

# 获取用户 quota 信息
curl https://api1.link-ai.cc/api/user/self \
  -H "Authorization: Bearer 你的APIKey"

# 响应中的 quota 相关字段
{
  "quota": 998.50,        # 页面显示余额
  "raw_quota": 999.00,    # 原始 quota
  "quota_per_unit": 0.01  # 每单位价格
}

站长侧建议：无有效输出时的处理

如果你是中转站的运营者，建议采用以下扣费逻辑：

if (final_output_tokens == 0) {
  // 无有效输出，final_quota = 0，返还预扣费
  refund_precharge()
} else {
  // 有有效输出，按实际消耗结算
  final_quota = actual_tokens * price_per_token
}

这不仅是对用户的公平，也是建立长期信任的基础。

更多错误码和排查口径，参考 OpenAI-compatible API Gateway 与 no available channel 排查。

FAQ