开发者文档 计费口径
计费口径
价格怎么定、一次调用怎么计费、费用怎么计入预算,以及调用记录里各项的来历。
计量项
每次调用按用量计费,用量以上游回报为准。用量分成下面几项,各有单价:
| 计量项 | 计价单位 | 说明 |
|---|---|---|
| 输入 | 每百万 tokens | 上游单独回报缓存时,不含缓存读取和缓存写入 |
| 缓存读取 | 每百万 tokens | 命中提示缓存的输入 |
| 缓存写入 | 每百万 tokens | 部分模型分 5 分钟和 1 小时两档 |
| 输出 | 每百万 tokens | 上游单独回报推理时不含推理;部分视频模型也按输出 tokens 计价 |
| 推理 | 每百万 tokens | 没有单独标价时按输出价 |
| 图片输入、图片输出 | 每百万 tokens | 按 tokens 计量的图片 |
| 输入图片、输出图片 | 每张 | 按张计量的图片,包括视频任务的参考图 |
| 视频、输入视频 | 每秒 | 生成的视频和输入的视频时长 |
| 输入字符 | 每个 | 语音合成的文本 |
有的价格规则每次调用含一定数量的免费单位,模型详情里标为「每次调用包含」。
价格
- 控制台「模型」页的模型详情列出当前价格;已排期的调价也会列出生效日期和新价格。
- 预算一律按美元扣减。以人民币标价的模型,按模型详情里标明的固定汇率折成美元,详情同时显示原价。
- 价格按版本发布,发布后不再修改,调价会发布新版本。一次调用按它开始时生效的版本计价,视频任务按任务创建的时间。
- 一个版本可以有多条规则,按顺序取第一条条件全部满足的,最后一条没有条件。条件可以是:输入 tokens 超过某个档位(输入含缓存读写)、上游回报的服务等级、每天的时段(按价格标明的时区)、限时区间、输出图片的像素数、视频分辨率、视频任务是否带输入视频。
- 模型有多条上游线路时,按实际处理这次调用的线路计价;「模型」页展示的是首选线路的价格。
- 调用详情的「计价」列出这次用到的价格版本和规则。
金额
一次调用先把各计量项的费用精确相加,再折成美元,四舍五入到百万分之一美元。预算、调用记录和用量报表都用这个精度。
用量状态
调用详情的「用量状态」说明计费用的用量从哪来:
| 用量状态 | 含义 | 计费 |
|---|---|---|
| 厂商已回报 | 上游在响应里回报了用量 | 按回报的用量 |
| 部分回报 | 流式调用只收到开头的用量,没收到最终用量 | 按已回报的部分 |
| 网关估算 | 你中途断开了连接;或语音合成、视频任务的上游没回报用量,网关按请求文本或任务时长估算 | 按估算的用量 |
| 厂商未回报 | 上游没有回报,网关也无法估算 | 不计费 |
| 回报异常 | 上游回报的数字前后矛盾 | 不计费 |
上游返回错误的调用,以及失败、取消或过期的视频任务,都不计费。网关在转发前就拒绝的请求(例如 401、402、403)不产生调用记录,也不计费。/v1/messages/count_tokens 不计费。
断开连接
- 对话接口(
/v1/chat/completions、/v1/responses、/v1/messages):调用结束前断开连接,网关会停止上游生成,正在收尾时最多再等 5 秒。已回报的用量照用,缺的部分按请求内容和已生成的内容估算,调用记录的状态为499。 - 其他接口:断开连接不会取消上游,调用照常完成并计费。
视频任务
- 提交时按请求的时长、分辨率等参数预估一笔费用,任务结束前计入预算的「已用」。
- 任务结束后结算,预估随之撤销:成功的按上游回报的用量计费,没回报时按任务的时长和分辨率估算;失败、取消或过期的不计费。
- 你查询任务时网关会更新状态,也会定期自动检查:提交约 1 分钟后第一次,之后间隔逐步拉长,最长 10 分钟。
- 提交 8 天后仍未结束的任务,按预估金额计费。
- 视频任务的调用记录在结算后才出现在「我的用量」,时间记为提交时间。
预算怎么扣
- 费用计入密钥所属的预算:个人密钥计入本人的月度预算,项目下的密钥计入项目预算。控制台「模型试验场」的调用计入你本人的预算。
- 个人预算按北京时间的自然月计算,每月 1 日重置:剩余 = 组织设定的每月额度 + 当月额度流水合计 − 当月已用。组织不限个人额度时,个人预算没有上限。
- 项目预算不按月重置:剩余 = 项目全部额度流水合计 − 项目累计已用。
- 「已用」是调用费用加上未结束视频任务的预估;个人预算按调用开始的时间归入月份。
- 剩余不大于零时,网关几秒内开始对这个预算下的密钥返回
402。检查只在调用开始时进行,进行中的调用会继续完成并计费,所以已用可能略超额度。 - 调用费用不写入额度流水,额度流水只记录额度本身的增减。申请与审批见额度申请与飞书审批。
调用记录
控制台「我的用量」列出网关转发给上游的每次调用,包括失败和中途断开的:
- 列表显示时间、模型与请求编号、状态、密钥、tokens、费用和耗时;请求编号就是响应头
X-Request-Id。 - 调用详情还有上游模型、各项 tokens、计价、用量状态和上游请求 ID,出错或无法计价时附原因。
- 一次调用只记录最后处理它的那条上游线路。
- 记录保存调用时密钥所属的成员、团队和项目,之后的人员或团队变动不会改写历史记录。
实际可调用的模型、授权与价格以控制台为准。
页面字体:MiSans(小米,依《MiSans 字体知识产权许可协议》使用);Google Sans Flex(SIL Open Font License 1.1)。
页面字体:MiSans(小米,依《MiSans 字体知识产权许可协议》使用);Google Sans Flex(SIL Open Font License 1.1)。