> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wengaocloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 计费与 Usage 字段

> 说明 token、图片、视频和缓存 token 的公开计费口径。

不同接口的 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` 计费，创建时冻结，任务成功后按成功存储并返回的图片数结算，失败退款 |

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

## 火山图片补充说明

* `/volcengine/v3/images/generations` 使用单独的图片计费规则。
* 如果请求携带 `image` 参考图，账单公式会额外展示输入图费用。
* 输出图价格会按响应里每张图片的 `size` 逐张结算，而不是只按请求时的 `size` 估算。

## Grok Imagine 视频计费口径

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

| 字段                        | 说明                 |
| ------------------------- | ------------------ |
| `billing_unit`            | 固定为 `video_second` |
| `requested_units`         | 请求的 `duration` 秒数  |
| `billable_units`          | 对外结算单位数，通常为输出视频秒数  |
| `billable_input_images`   | 实际计费的输入图张数，存在时返回   |
| `billable_output_seconds` | 实际计费的输出视频秒数，存在时返回  |
| `input_charge_amount`     | 输入图费用，存在时返回        |
| `output_charge_amount`    | 输出视频费用，存在时返回       |
| `charge_amount`           | 本次任务总费用，存在时返回      |

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

```text theme={null}
输入图费用 = 输入图张数 * 输入图单价
输出视频费用 = 输出视频秒数 * 输出视频单价
总费用 = 输入图费用 + 输出视频费用
```

任务失败、取消或超时后，平台会将冻结金额退回 API Key 余额。更多说明见 [Grok Imagine Video 001](/guides/grok-imagine-video-001)。

## 对账建议

* 记录每次请求返回的 `id` 或 `request_id`。
* 保存响应中的 `usage` 字段。
* 用控制台用量账单做最终对账。
* 如果 usage 缺失或字段异常，以平台账单和排障结果为准。