Skip to main content

简短回答

后台日志页面的**「消费」列**就是这次调用的美元金额。看懂它只需要记住四件事:
  1. 按量计费的模型(绝大部分文本模型,以及 gpt-image-2、SeeDance 2.0 系列等)在接口响应的 usage 字段里返回 token 数,成本可以自己算;
  2. 按次计费的模型接口里不返回金额,但单价固定,成本 = 调用次数 × 固定单价,同样好算;
  3. 日志里的金额是折扣前的,实际成本还要除以你的充值加赠比例(例如加赠 10% 就是 ÷1.1,约 91 折);
  4. 日志只记录成功计费的调用——报错是在接口里返回的,没有产生扣费的失败调用不会出现在日志里,也不会计费。
一句话版:按次计费 = 固定成本;按量计费 = 按 tokens 计算,接口里有返回。

日志各列怎么读

按次计费的模型在「提示 / 补全」列也可能显示 token 数,但金额不是由这两列推导出来的——判断方法很简单:同参数多次调用金额恒定、且是 0.030000 这种整齐数字的,基本是按次计费。

两种计费方式

按量计费(按 tokens)

接口响应的 usage 字段直接返回 token 数,成本 = 输入 tokens × 输入单价 + 输出 tokens × 输出单价。覆盖范围:绝大部分文本模型,以及 gpt-image-2SeeDance 2.0 系列等按 token 计价的图像 / 视频模型。

按次计费(固定单价)

接口里不返回金额,但每次调用价格确定,成本 = 次数 × 固定单价,预算最好估。覆盖范围:多数按张 / 按秒定价的图像、视频模型。单价在后台「模型价格」页面查询。

接口能直接返回花费金额吗

不能返回金额,但成本完全可算
  • 按量计费:用响应里的 usage 自己乘单价——这是官方口径的 token 数,比任何估算都准;
  • 按次计费:单价固定,直接用次数乘即可。
之所以不在响应里塞金额,是因为同一次调用的最终成本还取决于分组倍率你账户的充值加赠比例,把一个”半成品金额”写进响应反而容易误导对账。

用 usage 自己算

按量计费模型的响应里会带类似结构:
对应的成本公式:
命中缓存的那部分输入按缓存命中价计费(通常是输入价的 0.1 倍左右),所以长上下文场景下日志金额可能远低于按 prompt_tokens 全价估算的结果。详见缓存计费说明

gpt-image-2 的 token 查看方法

图像模型的 token 构成(输入图片、输出图片分别折算多少)在模型总览页的定价章节有实测数据

为什么日志金额是「折扣前」的

日志记录的是按模型价格算出的原始金额。你的实际成本还要再打一次折——因为充值时拿到了加赠额度:
举个例子:某次调用日志显示 $0.011,你的充值加赠是 10%,那么实际成本是 0.011 ÷ 1.1 = 0.01,相当于打了 91 折。

查看充值加赠阶梯

各档加赠比例、首充加赠与发放规则
分组折扣不用再算一遍:模型分组的倍率在计费时已经生效,日志里的金额就是含倍率的结果。需要另外折算的只有充值加赠这一层。倍率概念见模型倍率说明

失败的调用会计费吗

不会,而且不会出现在消费日志里。 这是理解日志的关键一点:
报错是在接口里返回的,后台日志是记录成功计费用的。 所以”日志里没有这条记录”通常等价于”这次调用没有扣费”。
典型例子:调用 gpt-image-2 时如果返回
这类请求会被直接返回、不做重试,因此后台不会产生消费记录,也不计费。同理,VEO、Sora 2 等视频模型返回 PUBLIC_ 前缀的错误时,属于上游官方内容审核拦截,同样不计费,调整提示词后可直接重试。
反过来也成立,这在排查问题时非常有用:如果日志里这条计费记录,说明请求确实到达了上游并产生了消耗;如果没有,那问题多半发生在到达上游之前(网络、鉴权、参数校验等)。「有没有计费记录」往往是定位断连类问题最有力的判据。
预扣额度 ≠ 计费:请求执行前系统会先冻结一笔预估额度,请求失败会释放,最终按实际消耗结算。看到余额短暂减少又恢复属于正常现象,详见预扣费机制

常见问题

正常。按量计费下金额随用量浮动,常见原因有:
  • 输入长度不同:长上下文、多轮历史、图片和音频都会显著推高输入 tokens
  • 思考 tokens:开启推理的模型会产生额外的输出 tokens,计入「补全」列
  • 缓存命中差异:命中缓存的输入按更低的缓存价计费,同样的 prompt 第二次可能便宜很多
  • 图像/视频参数:分辨率、时长、张数直接决定 token 数或计费次数
接口返回的 usage 和日志为准,两者同源。自己统计对不上通常是因为:多模态内容(图片、音频)会按官方规则折算成 tokens;系统提示词、工具定义(tools schema)也计入输入;思考 tokens 计入输出但不一定出现在可见文本里。
登录后台在「模型价格」页面查询,或查看站内的模型价格总览。按次计费模型的价格是确定值,乘调用次数即为成本。
先在日志里按时间点核对是否真的产生了消费记录。如果确认存在异常扣费,联系客服并提供日志中的时间戳和模型名即可核查处理,我方问题导致的损失会补发额度,详见 SLA 保障
看不到。出于隐私保护和存储成本考虑,日志只保留计费所需的基础信息(时间、模型、token 计数、金额),不记录具体的输入输出内容。详见如何查看调用记录

相关文档