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"