MossHubAPI 文档
开发者文档 计费口径

计费口径

价格怎么定、一次调用怎么计费、费用怎么计入预算,以及调用记录里各项的来历。

计量项

每次调用按用量计费,用量以上游回报为准。用量分成下面几项,各有单价:

计量项计价单位说明
输入每百万 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)。

本页目录