按量计费

理解用量、单价和历史费用。

费用计算

费用等于实际数量乘以基础单位美元单价。输入、输出和缓存分别按适用费率计算；图片、秒数和搜索次数使用各自单位。示例：1,000 输入 Token × $0.000002 + 500 输出 Token × $0.000008 = $0.006。

价格与时段

优先部署价格，再查询目录。缺少价格不等于免费。高峰和空闲费率按调用开始时刻及 Asia/Shanghai 时区选择。

日志与对账

请求日志显示用量、金额和价格快照。快照保存当次价格，改价不重写历史金额。本地费用须与供应商对账；分页日志和有限扫描的活动报表不等于完整账单。

单位与价格来源

先尝试部署价格，再查目录价格。价格缺失不等于免费。分辨率、音频、思考模式和时段决定适用费率行，以价格快照为准，不套用统一倍率。

完整计算示例

以下是演算费率，不是固定报价。输入 $2 / 百万 Token、输出 $8 / 百万 Token：1,000 输入 + 500 输出 = $0.006。

缓存输入 $0.50 / 百万 Token 时，总输入 1,000 中含 600 缓存，加 500 输出：费用 = (400 × 2 + 600 × 0.5 + 500 × 8) / 1,000,000 = $0.0051。缓存输入是总输入的子集，不能叠加计费。

图片 $0.04 / 张，实测 3 张 = $0.12；视频 $0.10 / 秒，实测 8 秒 = $0.80。请求期望时长不能当作完成用量。

展示单位与存储单位

usd 已是每基础单位单价：费用 = quantity × usd。unit_size 记录原始报价单位，不再除一次。例如 $2 / 1,000 Token 保存为 usd=0.002，1,500 Token 费用 $3。每百万 Token 的展示价格只转换一次。

Token 与多模态输入

Token 是模型切分单位，不等于字数。系统提示、历史消息、工具定义都占用输入。输出上限不是实测消耗。思考与图片、音频输入按供应商用量和适用费率计算，不将明细再次加入总量。明确 0 保持 0，字段缺失可能估算，秒和张数不能伪装成 Token。

缓存、失败与重试

供应商提示缓存仍按缓存价收费。XHub 完整响应缓存是独立机制：本地命中新增生成费为零，返回 usage 可能保留之前结果。失败调用本地新增费用为零，供应商可能收取尝试或部分输出费用。当前无完整逐尝试供应商账本，重试与流式中断必须对账。

高峰与空闲时段

按开始时刻的 Asia/Shanghai 时区选价。正常工作日 [09:00,12:00)、[14:00,18:00) 为高峰；周末与已维护的中国节假日覆盖为空闲。跨时段仍用开始窗口，缺少准确变体时核对 fallback 标记。

异步结算与对账

创建和等待查询不推断生成费。成功终态且有正实测用量时，按调用方、传输、任务和部署范围结算一次，重复查询不增加生成费。

按 x-litellm-call-id 查日志，核对 usage、price_snapshot 和费率数量。x-litellm-response-cost 是本地美元金额，不代表数据库提交。改价不重写历史快照，没有价格快照的记录可能 source=recomputed。日志需翻页，活动报表最多扫描 5,000 事件，单页不是完整账单。用量记账不提供汇率、税费、退款或充值支付功能。