计费规则详解

本文档说明 RelayFlows 的充值规则、API 计费方式与扣费逻辑。

想看自己的实际花费，进 用量统计；想算预估月费，看 费用计算示例。

# 1. 基础货币

RelayFlows 以 $（美元等价 token quota） 为站内基础计费单位。

充值规则：

1 CNY = 1 $

• 充值 10 CNY → 到账 10 $
• 充值 100 CNY → 到账 100 $

这是站内换算，不等于真实美元汇率。我们用统一的 1:1 换算把人民币充值额转成站内 quota，方便计费透明。

# 2. API 计费方式

平台 API 调用费用 = 模型官方 API 单价 × 分组倍率。

# 计费项

一次 API 调用可能包含以下计费项：

不同模型支持的计费项不同，以 模型定价 实际列表为准。若未使用缓存，缓存相关费用为 0。

# 3. 计费公式

# 3.1 官方 API 费用

官方费用 =
    输入 token 数  × 输入单价
  + 输出 token 数  × 输出单价
  + 缓存创建 token × 缓存创建单价
  + 缓存读取 token × 缓存读取单价

# 3.2 平台最终扣费

平台扣费 = 官方费用 × 分组倍率

即：先按模型官方单价 + 实际 token 消耗算官方费用，再乘以你所在分组的倍率，从账户余额扣除。

# 4. 分组倍率换算表

平台对不同模型分组 / 渠道分组设置不同倍率。常见倍率：

换算逻辑：假设官方一次调用要 $1 USD（≈ 7.1 CNY），在 1× 分组里你站内扣 1 $（= 1 CNY），所以实际只花了官方的 1/7.1 ≈ 0.14 倍。

具体分组倍率以 模型定价 页面与你的 订阅 / 分组 页面所示为准。

# 5. 计费示例

场景：分组倍率 = 1.5

• 官方 API 费用 = $10（按 input/output/cache 各项算出）
• 平台扣费 = $10 × 1.5 = $15
• 折合人民币消耗 = ¥15（1 CNY = 1 $）

# 6. 扣费规则细节

• 所有 API 调用按实际消耗的 token 数量计费
• 不同模型的输入 / 输出 / 缓存创建 / 缓存读取单价可能不同
• 不同分组的倍率可能不同
• 若某模型不涉及某项计费（例如无 cache 支持），该项费用按 0 计算
• 最终扣费金额以平台实际计算结果为准（实际 token 数由上游模型返回，本站不二次修改）

# 7. 余额不足时的行为

API 请求产生费用后，系统自动从账户余额扣除对应 $。余额不足时：

• 请求被拒绝（HTTP 402）
• 错误返回 INSUFFICIENT_BALANCE
• 系统提示余额不足

详见 错误码参考 - 402。

# 8. 计费总结

平台扣费 = 官方 API 费用 × 分组倍率

其中：
  官方 API 费用
    = 输入费用 + 输出费用
    + 缓存创建费用 + 缓存读取费用

充值规则：1 CNY = 1 $