모델 id 및 변형

api14의 모델 id는 provider/model 형식을 사용합니다(예: openai/gpt-5-mini). 모든 요청의 model 필드에 id를 전달하세요.

{ "model": "anthropic/claude-sonnet-4.5" }

모델 id 찾기

• 모델 페이지에서 모든 모델의 id, 가격, 컨텍스트 길이, 기능을 확인하세요.
• 코드에서 GET /models를 호출하세요. ?category=image로 카테고리를 필터링할 수 있습니다. 모델을 참고하세요.

몇 가지 예시입니다.

id는 대소문자를 구분합니다. 알 수 없거나 비활성화된 id는 404 model_not_found를 반환합니다.

변형

변형은 콜론 뒤에 붙는 접미사로, 요청이 처리되는 방식을 바꿉니다. 변형은 같은 기본 모델에서 동작하며, 기본 모델의 가용성과 허용 목록 규칙이 그대로 적용됩니다.

{ "model": "openai/gpt-5-mini:online" }

:nitro와 :floor는 제공자 정렬의 단축 표기로, 각각 provider: { sort: "throughput" }, provider: { sort: "price" }와 같습니다. 제공자 라우팅 및 폴백을 참고하세요.

모델 폴백

첫 번째 모델이 실패하거나 사용할 수 없을 때 다른 모델을 시도하려면 models 배열을 보내세요.

{
  "model": "anthropic/claude-sonnet-4.5",
  "models": ["openai/gpt-5-mini", "google/gemini-2.5-flash"],
  "messages": [{ "role": "user", "content": "Hello" }]
}

목록의 모든 모델은 키와 요금제에서 사용 가능하고 허용되어야 하며, 그렇지 않으면 요청이 전송되기 전에 거부됩니다. 응답의 model 필드로 어느 모델이 답했는지 알 수 있으며, 그 모델의 가격이 청구됩니다.

허용 목록과 요금제

• 모델 허용 목록이 있는 키는 목록에 있는 id만 사용할 수 있으며, 다른 id는 403 model_not_allowed를 반환합니다.
• Free를 포함한 모든 요금제는 동영상과 음악/오디오를 포함한 모든 모델 카테고리를 제공합니다. 특정 카테고리로 제한된 요금제는 나머지 카테고리에 대해 403 plan_required를 반환합니다. 요금 및 결제를 참고하세요.

모델 변경

카탈로그는 자동으로 업데이트됩니다. 새 모델은 저절로 나타나고, 제거된 모델은 404 model_not_found를 반환합니다. 프로덕션에서는 정확한 id를 고정하고, 안정성을 위해 models 폴백을 사용하세요.