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 합계 |
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"