huigen.慧根 API
用量与费用

API Token 怎么计费?输入、输出、缓存与账单核对

慧根 API 编辑 · 发布 / 更新于

用假设算例理解输入、输出和缓存 Token 计费,区分站内美元额度与人民币充值金额,并核对 API 调用记录。

API Token 怎么计费?输入、输出、缓存与账单核对操作路线图
图解路线 · 正文按步骤说明操作与检查结果。 点击图片查看大图

先区分充值额度和一次调用费用

充值决定账户可用额度,一次模型调用消耗其中一部分。API 费用通常与模型、分组和 Token 用量有关,不能用“问了几个问题”直接推算。长对话、工具返回内容和较长输出,都可能改变实际用量。

慧根当前页面使用 USD 显示站内额度。充值支付币种与到账额度是另一层换算关系,以实际订单为准;不要把页面中的额度单位直接当成人民币,也不要把站内换算当作实时外汇报价。

输入、输出与缓存分别表示什么

  • 输入 Token:发给模型的内容,可能包括系统指令、历史对话、代码和工具结果。
  • 输出 Token:模型生成并被服务计入输出的内容,具体口径以返回用量与站内规则为准。
  • 缓存 Token:部分输入命中或写入缓存时,可能按独立单价计费。是否支持、如何统计,取决于模型与渠道。

重复问同一个问题不保证命中缓存;缓存写入也不一定免费。先看当前价格页是否列出读取、写入及其他计费项,再核对日志。Token 不是固定字数,中文、英文、代码的比例也不相同。

步骤 1:找一条具体调用记录

进入调用记录并定位时间

打开调用记录,选一条你能对应到客户端操作时间的记录。若一次操作触发多次工具调用或重试,先分开核对。

完成后检查:记下模型、分组、输入 Token、输出 Token、缓存相关项和扣费。没有展示的字段标成“未提供”,不要填 0。

记录数据,避免只看余额变化

用下面的清单整理一条调用;真实记录中不要包含 API 令牌。

完成后检查:同一条记录的数据可与对应价格规则逐项核对。

调用时间:
模型 / 分组:
普通输入 Token:
输出 Token:
缓存读取 / 写入(若有):
当时适用单价与单位:
记录扣费:

步骤 2:对照价格单位,再代入公式

以下数字仅演示计算,不是慧根报价。假设某模型每百万输入 Token 为 2 美元、每百万输出 Token 为 8 美元;一次调用产生 10,000 个普通输入 Token 和 2,000 个输出 Token,且没有缓存或其他计费项:

输入费用 = 10,000 / 1,000,000 × 2 = 0.020 美元
输出费用 =  2,000 / 1,000,000 × 8 = 0.016 美元
合计费用 = 0.036 美元

有独立缓存价格时,应按服务的用量口径拆分计费桶。如果输入总数已经包含缓存读取 Token,不能既把全部输入按普通价格计算,又额外加一次缓存读取费用。不同协议用量字段不同,核对时先确认各项是否重叠。

如果页面采用倍率、分组系数或其他展示方式,还需按该页规则换算,不能直接套用上面的假设单价。

步骤 3:核对缓存与重复请求

  1. 时间与请求:是否把自动重试、多个工具调用或多个并发会话算成了一次?
  2. 模型与分组:日志中的模型和分组,是否与查看报价时一致?
  3. 单位:单价是每千还是每百万 Token,费用显示是什么币种或额度单位?
  4. 用量口径:普通输入、缓存读取、缓存写入、输出是否分别计费,有没有重复计算?

先从调用记录选择一条记录逐项核对,再观察整段会话。价格可能更新;排查历史调用时,需要核对调用当时的计费规则。

检查是否把缓存算了两次

如果输入总数包含缓存读取量,先按该协议和渠道规则拆分普通输入与缓存读取,再分别计算。核对重试是否形成了额外调用记录。

完成后检查:每一项用量只进入对应的计费桶一次。无法确认口径时,携带请求 ID 和去敏记录联系客服核查。

控制费用从小请求和清晰记录开始

首次接入先测试小请求,再逐步加入文件、长上下文和并发任务。为不同工具建立独立令牌,按需要设置额度限制,便于定位消耗来源。额度限制的具体生效规则以控制台说明为准。

减少无关历史上下文、避免重复提交大文件、为输出设置合适上限,都有助于控制用量。不要为了省 Token 删掉任务必要信息;应先在调用记录中确认主要消耗来自输入还是输出。