每个 API 响应都包含 usage 对象，其中详细列出了本次请求的 token 使用量和成本信息。 你可以使用这些信息来监控和优化 API 使用成本。
Usage 对象
响应中的 usage 对象包含以下字段：
| 字段 | 描述 |
|---|---|
prompt_tokens | 输入 tokens 总数 |
completion_tokens | 输出 tokens 总数 |
total_tokens | tokens 总数（输入 + 输出） |
reasoning_tokens | 推理 tokens（如适用） |
prompt_tokens_details.text_tokens | 文本输入 tokens |
prompt_tokens_details.cached_tokens | 缓存输入 tokens |
prompt_tokens_details.image_tokens | 图像输入 tokens |
prompt_tokens_details.audio_tokens | 音频输入 tokens |
Token 类型
所有标准 token 类型都按请求中使用的模型计费：
- 输入 tokens — 你的查询和对话历史
- 推理 tokens — 智能体的内部思考和规划
- 输出 tokens — 最终响应
- 图像 tokens — 视觉内容分析
- 缓存 tokens — 从缓存提供（折扣价格）
成本计算
每种 token 类型有不同的价格。例如，grok-4.5 的价格为： 输入 $2.00 / 1M，缓存输入 $0.50 / 1M，输出 $6.00 / 1M。 工具调用也有额外费用（如网络搜索 $5 / 1K 次调用）。
控制台
你可以在 xAI 控制台中查看详细的费用报告和使用统计，包括按模型、按天和按工具的费用分解。