AI API 扣费检测工具：检测空回复扣费、503 扣费和预扣未返还

扣费异常的错误原理

很多中转站使用预扣费 + 最终结算机制。如果请求无有效输出但仍按 prompt tokens 或估算 usage 扣费，就会出现「空回复扣费」。

典型场景：

• 请求发出后收到 503 Service Unavailable，但额度已减少
• 模型不支持（invalid model），但仍扣除了估算费用
• 网络超时，页面报错 524，但余额少了
• 空回复（无 completion 文本），但扣了费用
• 预扣后未返还（请求失败但预扣金额未结算退回）

为什么前台余额看不出来？

页面余额通常只显示两位小数，无法发现 $0.0001 级别的变化。

扣费检测工具应优先读取 /api/user/self 返回的 raw quota（精确整数），再结合 /api/status 的 quota_per_unit 换算实际金额，而不是只看前台余额。

实际余额 (USD) = raw_quota / quota_per_unit

例如：
raw_quota = 99819128
quota_per_unit = 500000 (每个单位 = 500000 raw quota)
实际余额 = 99819128 / 500000 ≈ 199.64 USD

New API / One API 如何读取 raw quota？

New API / One API 类站点提供以下 API 端点读取精确余额：

第一步：获取 quota_per_unit

curl -s https://api1.link-ai.cc/api/status

响应中的 data.quota_per_unit 即为换算基数（如 500000）。

第二步：获取 raw quota

# 需要携带登录态（cookie 或 header）
curl -s https://api1.link-ai.cc/api/user/self \
  -H "Cookie: your-session-cookie" \
  -H "new-api-user: true" \
  --include

响应中的 data.quota 即为 raw quota（精确整数）。

注意：不依赖 /api/user/amount，因为它可能需要额外参数或返回经过舍入的值。

检测逻辑

工具通过以下步骤精确检测扣费异常：

什么是「有效输出」？

以下情况视为「有效输出」，扣费视为合理：

以下情况视为「无效输出」，不应扣费：

异常扣费分类

• 💸 失败请求扣费 请求返回 500/503/502 等 HTTP 错误，但额度仍然被扣除。典型场景：上游渠道宕机时。
• 📭 空回复扣费 API 返回成功（HTTP 200），但 response 为空（无文本、无 tool_call、无 image），却扣除了费用。
• 🔒 预扣未返还 请求开始时预扣了额度，请求失败后预扣金额没有结算返还，永久损失。
• ❌ 无效模型扣费 请求的模型不存在或无权访问，但站点仍然按估算 usage 扣费（如预估了 prompt tokens 消耗）。

503 请求到底有没有扣费？

从严格意义上说，503 Service Unavailable 不应产生最终扣费，因为请求没有到达上游模型，没有消耗任何 token。

但如果站点使用了预扣费机制，预扣可能在请求开始时就已发生，此时即使返回 503，额度也已经减少。如果预扣没有在结算周期内返还，就会出现「503 扣费」的假象。

通过 raw quota 对比可以精确判断：请求 503 前后的 raw quota 是否有变化。

报告示例

工具可生成包含以下信息的检测报告，可直接发给站点管理员：

插件支持状态

如果无法读取 raw quota，工具将降级为风险提示模式，通过对比页面余额变化和请求响应来判断是否存在扣费风险。

Link-AI 的扣费透明度

使用 Link-AI 时，以下原则确保扣费透明：

• 按量计费：只为实际消耗付费，不预扣
• 失败不扣：系统故障导致的 500 报错，扣费会在审计后自动返还
• 透明日志：控制台提供详细使用日志，每笔扣费可查
• api1/api2 分流：长请求用 api2，普通请求用 api1，均共享同一账户余额

如果发现异常扣费，可联系客服处理。

常见问题

相关教程