메인 콘텐츠로 건너뛰기
GET
요청 비용 조회
이 엔드포인트는 동기 API 호출의 비용을 조회하며, 주로 Chat Completions, Messages, Responses 등의 인터페이스를 통한 텍스트 모델 호출에 사용합니다.원래 응답의 X-Request-Id 헤더 값을 Request ID로 사용합니다. 요청이 완료된 후 잠시 기다렸다가 조회하세요. 비동기 작업은 작업 상태 조회를 사용하세요.

인증

Authorization
string
header
필수

모든 엔드포인트는 Bearer Token 인증이 필요합니다.

API Key 받기:

API Key 관리 페이지에서 API Key를 발급받으세요.

요청 헤더에 다음 내용을 추가하세요:

경로 매개변수

request_id
string
필수

원래 응답의 X-Request-Id 헤더 값인 Request ID입니다. 중괄호({})를 제외하고 ID를 경로 끝에 그대로 붙여 넣으세요.

Maximum string length: 64

응답

조회 성공

id
string
필수

Request ID

예시:

"20261117223155519063884QnAx70lK"

object
enum<string>
필수

객체 유형. 항상 request

사용 가능한 옵션:
request
예시:

"request"

model
string
필수

요청에 사용된 모델

예시:

"claude-haiku-5-5"

status
enum<string>
필수

요청 상태:

  • completed: 요청이 성공적으로 완료되었습니다.
  • failed: 요청이 실패했습니다. 실패 전에 사용량이 발생한 경우(예: 스트리밍 응답이 중간에 끊긴 경우), usage에 실제 차감된 비용이 반환됩니다.
  • blocked: 잔액 부족, API Key 한도 소진, API Key 비활성화 또는 만료, 허용되지 않은 모델 등의 이유로 처리 전에 요청이 거부되었습니다. 비용은 발생하지 않습니다.
사용 가능한 옵션:
completed,
failed,
blocked
예시:

"completed"

finished_at
integer
필수

요청 종료 시각(Unix 타임스탬프, 초 단위)

예시:

1794925917

usage
object
필수

사용량과 비용. 항상 반환되며, 비용이 발생하지 않은 경우 모든 값은 0입니다.

error
object

실패 사유. status가 failed 또는 blocked일 때만 반환됩니다. 설명 문구만 포함하며 오류 코드는 포함하지 않습니다. 오류 코드별로 처리해야 하는 경우 원래 요청에서 반환된 오류를 사용하세요.