API 레퍼런스
API Key 하나의 요청 로그 조회
BetterToken API Key 하나의 최근 요청 로그를 최대 1,000개 조회합니다. 타임스탬프, 요청 ID, Token 수와 각 기록의 통화로 표시되는 청구 금액을 확인하세요.
GET https://bettertoken.ai/api/log/token을 사용하면 BetterToken API Key 하나의 최근 요청 로그를 조회할 수 있습니다.
요청 보내기
모델 호출에 사용하는 것과 동일한 sk-... BetterToken API Key를 사용하세요. 다음 명령을 실행하기 전에 로컬 환경 변수 BETTERTOKEN_API_KEY에 설정하세요.
Authorization: Bearer <API_KEY>로 인증합니다. 요청에는 매개변수나 본문이 없습니다. 전체 URL에는 /v1이 포함되지 않습니다.
curl -sS 'https://bettertoken.ai/api/log/token' \ -H "Authorization: Bearer ${BETTERTOKEN_API_KEY}"성공 응답
성공하면 success는 true이며 data에는 이 Key의 로그 배열이 반환됩니다. 가장 최근에 작성된 기록이 먼저 나오며 최대 1,000개의 기록을 반환합니다.
이 API에는 페이지 나누기, 시간 필터 또는 요청 ID 필터가 없습니다.
예시에는 자주 사용하는 필드만 표시했습니다. 모든 값은 설명을 위한 예시입니다.
{ "success": true, "message": "", "data": [ { "created_at": 1795046400, "type": 2, "model_name": "gpt-6.2-sol", "request_id": "example-request-id", "prompt_tokens": 120, "completion_tokens": 48, "quota": 600, "recorded_amount": "0.0012", "currency": "USD" } ]}로그 필드 읽기
| 필드 | 의미 |
|---|---|
created_at | 초 단위 Unix 타임스탬프입니다. |
model_name | 모델 ID입니다. |
request_id | 이 필드가 있으면 기록을 모델 요청과 연결할 수 있습니다. |
prompt_tokens | 기록된 입력 Token 수입니다. API와 청구 방식에 따라 달라집니다. |
completion_tokens | 기록된 출력 Token 수입니다. API와 청구 방식에 따라 달라집니다. |
type | 2는 소비 기록을 뜻합니다. |
quota | 기록된 할당량 값입니다. 내부 할당량 단위입니다. |
recorded_amount | 십진수 문자열로 표시한 금액입니다. 청구 환산 계수가 저장된 소비 기록에서 반환됩니다. |
currency | 금액의 통화입니다. 예: USD. |
금액 처리
recorded_amount가 없을 때 비용을 0으로 처리하지 마세요. currency별로 나누어 합산하세요.
관련 조회
이 Key의 누적 사용량과 남은 할당량은 API Key 할당량 조회를 참고하세요. 계정 전체 기록은 BetterToken Workspace에서 확인하세요.

