콘텐츠로 이동
무료 가입
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와 청구 방식에 따라 달라집니다.
type2는 소비 기록을 뜻합니다.
quota기록된 할당량 값입니다. 내부 할당량 단위입니다.
recorded_amount십진수 문자열로 표시한 금액입니다. 청구 환산 계수가 저장된 소비 기록에서 반환됩니다.
currency금액의 통화입니다. 예: USD.

금액 처리

recorded_amount가 없을 때 비용을 0으로 처리하지 마세요. currency별로 나누어 합산하세요.

관련 조회

이 Key의 누적 사용량과 남은 할당량은 API Key 할당량 조회를 참고하세요. 계정 전체 기록은 BetterToken Workspace에서 확인하세요.