메인 콘텐츠로 건너뛰기
GET
모델 가격 조회

엔드포인트 정보

이 엔드포인트에는 요청 매개변수가 없습니다. 요청마다 인증 헤더를 포함하세요.

1. 인증

HTTP 헤더에 Bearer 자격 증명을 포함하세요. 다음 두 가지 중 하나를 사용하세요.
자격 증명이 누락되었거나 유효하지 않거나 삭제 또는 비활성화된 경우, 또는 계정이 비활성화된 경우 인증에 실패합니다.

2. 공통 응답 구조

애플리케이션 상태 코드

요청 성공 여부는 응답 본문의 code로 확인하세요.

금액 형식

  • 모든 금액은 미국 달러(USD) 기준이며 부동소수점 정밀도 손실을 방지하기 위해 문자열로 반환됩니다.
  • 잔액 관련 금액은 항상 소수점 이하 네 자리로 표시됩니다. 예를 들어 "986.9275"입니다.
  • 모델 단가는 소수점 이하 자릿수를 0으로 채우지 않습니다. 예를 들어 "40", "2.5", "0.00075"입니다.

3. 모델 가격 조회

3.1 자격 증명별 조회 범위

3.2 data 필드

3.3 groups (그룹 및 할인)

auto 그룹은 요청을 실제로 처리한 그룹의 배율로 과금됩니다. auto의 ratio는 참고용입니다.

3.4 supportedEndpoint (엔드포인트 유형)

각 키는 엔드포인트 유형이며 값은 해당 유형의 요청 메서드와 경로를 나타냅니다.
이 객체에는 반환된 모델이 사용하는 엔드포인트 유형만 포함됩니다. 모델의 supportedEndpointTypes에 나열된 유형으로 요청 경로를 찾을 수 있습니다.

3.5 models (모델 및 가격)

3.6 prices (가격 항목)

토큰 기준 과금 (100만 토큰당 USD) 요청, 초 또는 이미지 기준 과금 구간별 가격 항목은 위 키에 구간 접미사를 붙입니다. 텍스트 입력은 text 접두사를 생략하여 inputTokens를 사용합니다. K는 1천 토큰, M은 100만 토큰을 뜻합니다. 예를 들어 272K는 272,000토큰이고 1M은 1,000,000토큰입니다.

3.7 tierBasis (과금 구간 결정 기준)

Lte272K처럼 같은 접미사를 사용해도 모델마다 구간 결정 기준이 다를 수 있습니다. 적용 기준은 tierBasis에서 확인하세요. 과금 규칙
  1. 요청 전체에 하나의 구간을 적용합니다. 요청의 사용량으로 구간을 결정하며, 입력, 출력, 캐시 등 모든 항목에 해당 구간의 단가를 적용합니다. 구간별 누진 과금은 적용되지 않습니다.
    • tierBasis = ["context"]인 모델에서 컨텍스트가 300K이면 Gt272K 구간에 해당합니다. 입력, 출력, 캐시에 각각 해당하는 xxxGt272K 단가가 적용됩니다.
  2. 컨텍스트 길이에는 캐시 적중분이 포함됩니다. 텍스트 입력에서는 캐시 적중분을 제외합니다.
    • 새 입력 200K와 캐시 적중 100K가 있으면 컨텍스트 길이는 300K(Gt272K), 텍스트 입력은 200K(Lte272K)입니다.
  3. ["input", "output"]처럼 기준이 여러 개라면 모든 조건을 충족해야 해당 구간이 적용됩니다.
  4. 시간대별 과금에는 두 가지 방식이 있습니다.
    • prices에 피크 및 비피크 시간대의 xxxPeak와 xxxOffPeak 단가가 모두 표시됩니다.
    • prices에는 기본 단가만 표시되며 피크 시간에는 배율이 적용됩니다. 구체적인 시간대와 배율은 계정 담당자에게 문의하세요.

3.8 billingType (과금 유형)

pricingConfig 구조는 모델마다 다릅니다. 실제 설정은 API 응답을 확인하세요.

3.9 실제 적용 단가

textInputTokens가 "8"인 모델을 ratio = 0.86인 그룹에서 호출하면 실제 입력 단가는 8 × 0.86 = 100만 토큰당 6.88달러입니다.

3.10 응답 예시

다음은 응답의 일부를 보여 주는 예시입니다.
API 키를 사용하면 groups에는 해당 키의 그룹만, models에는 해당 그룹에서 사용 가능한 모델만 포함됩니다. 응답에 tokenName도 추가됩니다.

4. 요청 예시


5. 참고 사항

  1. 갱신 주기. 모델 가격 변경은 약 1분 이내에 적용됩니다.
  2. 기본 가격. prices의 모델 기본 가격에 사용한 그룹의 ratio를 곱하면 실제 적용 단가를 계산할 수 있습니다.
  3. 최종 청구 금액. 이 엔드포인트는 조회 및 추정용입니다. 최종 청구 금액은 청구서를 확인하세요.
  4. 자격 증명 보호. 시스템 액세스 토큰으로 계정 전체 정보를 조회할 수 있으므로 외부에 공개하지 마세요. 특정 키의 한도만 조회하려면 해당 API 키를 사용하세요.