计费与用量

AI 摘要

TokenPostie 会把上游用量标准化为输入 token、输出 token、总 token、缓存命中 token 和 reasoning token。最终账单以 TokenPostie 的已确认用量、价格快照和账本结果为准。

标准用量字段

字段含义
inputTokens输入 token
inputContextTokens可选完整输入上下文,包含缓存读写,用于输入长度选档
cacheWriteTokens可选缓存写入输入 token
outputTokens输出 token
totalTokens总 token
cacheReadTokens缓存命中输入 token,只有上游支持时存在
reasoningTokensreasoning token,只有上游支持时存在

不同能力的口径

能力输入输出说明
Chatprompt/input tokencompletion/output token流式请求可能需要复核
Embeddingsinput token固定为 0不产生文本输出
Rerankquery + documents token固定为 0非 token 计量会进入复核

复核状态

当上游没有返回完整用量,或使用非 token 口径时,请求会进入复核。复核中的请求不会直接形成确定性扣费。

流式请求已经取得完整、合法的用量和协议终态后,即使随后发生网络断连,也会按真实用量结算。连接异常与已完成调用的费用是两个不同事实;请用请求 ID 对照账单,避免根据最后一次网络读取结果判断是否收费。

调用前的资金预留按微分精度检查,并覆盖输入、输出、缓存读写及推理的已配置费率;微小余额仍可支付可负担的调用。预留不是最终收费,实际扣款仍根据真实用量计算,各计费项的取整及月度阶梯分摊也纳入预留上界。

客户控制台账单

客户控制台账单页应展示:

区域内容
余额当前 API Key 或项目可见 Key 的余额
消费明细请求 ID、模型、时间、用量、客户费用、折扣
余额流水扣费、退款、调账和余额变化
汇总分析每日或每月请求数、成功率、Tokens、客户费用

客户侧账单接口只返回客户费用口径,不返回系统内部计算字段。

请求日志与账单的关系

请求日志用于排查调用是否成功、耗时多少、返回了什么错误码。账单用于确认已确认用量和最终客户费用。

建议对账时同时提供:

  • 请求 ID。
  • 请求时间范围。
  • API Key 脱敏预览。
  • 控制台账单明细。
  • 控制台余额流水。

最终用户侧注意事项

模型也可以按单次完整输入上下文长度分档计价,缓存读写仍计入选档长度。 例如标注“≤32k”的档位包含32000,32001则整次输入和输出按下一档计价, 不是把前32000按低档、超出部分按高档分摊;输出长度本身不影响输入档选择。 模型页展示售价范围和分档说明,账单展示已命中的输入档名和完整输入长度。 输入分档可与分时、月累计阶梯和项目折扣叠加,具体以已发布价格快照为准。

模型可以有分时段价格。模型页显示当前参考售价,多条服务路径的售价不同时会 显示范围。最终费用按请求开始时锁定的价格和实际用量计算;流式响应跨过优惠 结束时间时,同一请求保持原价格。账单明细保留锁价时间和已命中的优惠名称。 请以 TokenPostie 控制台价格为准,供应商公开优惠不代表客户价格同步变化。

  • 不要用客户端自行估算 token 作为最终账单依据。
  • 不要根据上游文档猜测 TokenPostie 对外价格。
  • 如果对账有疑问,应提供请求 ID、时间范围和 API Key 标识,由平台按日志和账本排查。
  • 如需发票,请继续阅读 发票与付款。