Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
ARouter 如何跟踪并报告每个请求的 Token 使用量、成本和耗时。
usage 对象在每个非流式响应（以及流式响应的最后一个数据块）中返回：
{
"id": "gen-abc123",
"model": "openai/gpt-5.4",
"usage": {
"prompt_tokens": 120,
"completion_tokens": 85,
"total_tokens": 205,
"prompt_tokens_details": {
"cached_tokens": 60,
"audio_tokens": 0
},
"completion_tokens_details": {
"reasoning_tokens": 30,
"audio_tokens": 0,
"accepted_prediction_tokens": 0,
"rejected_prediction_tokens": 0
}
}
}
| 字段 | 说明 |
|---|---|
prompt_tokens | 输入 Token 总数（包含缓存 Token） |
completion_tokens | 输出 Token 总数（包含推理 Token） |
total_tokens | 提示词 Token + 补全 Token 之和 |
prompt_tokens_details.cached_tokens | 从服务商提示词缓存中获取的 Token |
completion_tokens_details.reasoning_tokens | 用于内部推理的 Token（思考模型） |
completion_tokens_details.accepted_prediction_tokens | 推测解码接受的 Token |
completion_tokens_details.rejected_prediction_tokens | 推测解码拒绝的 Token |
成本 = (prompt_tokens × 每 Token 输入价格) + (completion_tokens × 每 Token 输出价格)
choices 为空：
{
"id": "gen-abc123",
"choices": [],
"usage": {
"prompt_tokens": 120,
"completion_tokens": 85,
"total_tokens": 205
}
}
stream_options: { include_usage: true } 来启用流式使用量统计。
# 获取当前余额
curl https://api.arouter.ai/v1/billing/balance \
-H "Authorization: Bearer $AROUTER_API_KEY"
# 列出最近的交易记录
curl https://api.arouter.ai/v1/billing/transactions \
-H "Authorization: Bearer $AROUTER_API_KEY"