API 开发文档

快速集成指南与完整 API 参考

计费逻辑

不同模型，扣费方式可能不同

并不是所有模型都按同一种方式计费。文本模型通常按 Token 计费，图片和视频模型则可能按次、按张或按时长计费。

如果你只想快速判断怎么收费，最简单的方法是先确认模型的 billing_type，再结合价格页或模型详情查看具体单价。

billing_type	它表示什么	常见使用场景
token	输入 / 输出 Token 分开计费，适用于大部分文本与多模态模型。	最常见于文本、对话和多模态理解类模型。
request	按成功请求次数结算。	常见于按次收费的接口，适合结果一次性返回的模型。
image_count	按最终返回图片张数结算。	常见于图片生成模型，返回几张图片就按几张计费。
duration_seconds	按视频时长（秒）结算。	常见于视频生成模型，视频越长，费用通常越高。
token_total	按总 Token 结算，不区分输入输出。	用于部分统一按总消耗计算的模型，不再拆分输入和输出。

先不用记全部规则

第一次测试时，不需要先掌握所有计费实现细节，只要知道不同模型可能有不同 billing_type 即可。

先查哪里

先看模型列表、价格页或模型详情，确认该模型到底按什么方式计费。

先怎么测

建议先用文本接口做接入验证，确认调用成功后，再测试图片和视频这类可能存在额外计费差异的能力。

在模型列表、价格页或模型详情里确认 billing_type 和单价，不要只根据能力类型猜费用。

文本先发短消息，图片先生成 1 张，视频先用短时长任务，减少首次验证成本。

在使用日志里核对模型、Token、请求状态和费用。如果视频失败或取消，以最终结算结果为准。