모델 티어

일부 모델은 여러 티어로 제공됩니다. 티어는 같은 모델을 다른 가격으로 판매하는 것입니다. 예를 들어 기본값 다음에 더 저렴한 티어가 있을 수 있습니다. 하나의 API 키로 모든 티어에 접근할 수 있으며, 별도의 키나 설정이 아닌 모델 이름으로 티어를 선택합니다.

기본값 티어

평문 모델 이름은 항상 기본값 티어를 사용합니다. 기존 요청은 모델이 다른 티어를 추가해도 변경되지 않고 계속 작동합니다.

{ "model": "gpt-image-2" }

티어 선택

모델 이름에 콜론과 티어 ID를 붙입니다:

{ "model": "gpt-image-2:<tier>" }

이것은 텍스트, 이미지, 비디오, 오디오 모델에서 작동하며, 요청에서 모델을 지정하는 모든 곳에서 사용할 수 있습니다: JSON 본문의 model 필드, 오디오 업로드의 model 폼 필드, Gemini 기본 경로의 모델 세그먼트. Gemini 경로에서는 작업이 마지막에 옵니다:

POST /v1beta/models/<model>:<tier>:generateContent

모델의 티어 찾기

• 각 모델 페이지의 가격 표 위에 티어 선택기가 있으며, 각 티어의 가격과 호출할 모델 ID를 표시합니다. 가격이 하나뿐인 페이지에서는 대신 가격 티어 표에 티어를 나열합니다. 둘 다 모델에 티어가 두 개 이상일 때만 나타납니다.
• 각 모델의 Markdown 가이드 /models/<page>/llms.txt에는 모든 티어의 전체 가격이 나열됩니다.
• GET /v1/models는 키로 두 개 이상의 티어에서 호출할 수 있는 모든 모델에 대해 <model> 옆에 <model>:<tier>를 나열합니다.

텍스트 모델의 Playground에서는 티어 선택기가 같은 티어들 사이를 전환합니다. 이미지, 비디오, 오디오 모델의 Playground는 기본값 티어를 사용합니다. 다른 티어는 API로 호출하세요.

청구 및 동작

• 티어 요청은 해당 티어에서만 실행되며 해당 티어의 가격으로 청구됩니다.
• 티어가 요청을 처리할 수 없으면 요청이 실패합니다. 다른 티어로 전환되지 않으므로 다른 가격으로 청구되지 않습니다.
• 응답과 작업 결과는 평문 모델 이름을 보고합니다.
• 한 개의 티어만을 위해 생성된 키는 해당 티어만 호출할 수 있습니다.

오류

응답 형식은 오류를 참고하세요.