计费与 Usage 字段

不同接口的 usage 字段和计费单位可能不同。

类型	常见字段	说明
文本 token	`prompt_tokens`、`completion_tokens`、`total_tokens`	OpenAI 兼容文本常见口径
Responses token	`input_tokens`、`output_tokens`、`total_tokens`	Responses API 常见口径
Cache token	`cached_tokens`、`cache_read_input_tokens`、`cache_creation_input_tokens`	以模型支持情况为准
图片	`data[]` 图片数量或平台任务结果数量	可能按张计费
视频	任务完成后的 usage 或结算字段	可能按 token、task 或 `video_second` 计费，以视频接口文档为准

图片计费口径

图片接口分两类，不建议混用：

接口	典型模型	响应方式	计费说明
`/volcengine/v3/images/generations`	`doubao-seedream-5-0-lite-260128`、`doubao-seedream-5-0-pro-260628`	同步返回 JSON，或模型支持时返回 SSE	冻结按请求预估，最终按每张实际响应尺寸结算；输入图与输出图分开计费
`/v1/images/generations`	`gpt-image-2`	同步返回图片响应	兼容 OpenAI 图片入口，具体按 token 还是按张以模型配置为准
`/v2/images/generations`	`gpt-image-2-async`	创建任务后查询结果	当前实现按 `image` 计费，创建时冻结，任务成功后按成功存储并返回的图片数结算，失败退款

图片异步接口当前不支持请求体传 n。如果需要多张图片，请创建多个异步任务；后续如开放批量，会在文档和 OpenAPI 中同步更新。

/v1/grok-imagine/videos/generations 使用 video_second 作为公开用量单位。对于 Grok Imagine Video 001 这类参考图生成视频的任务，账单可能会把费用拆成两部分：

实际单价以你的账号可见价格和最终账单为准，文档只说明计费口径。

输入图费用 = 输入图张数 * 输入图单价
输出视频费用 = 输出视频秒数 * 输出视频单价
总费用 = 输入图费用 + 输出视频费用

任务失败、取消或超时后，平台会将冻结金额退回 API Key 余额。更多说明见 Grok Imagine Video 001。