엔드포인트

모델

GET /models로 사용 가능한 모델의 가격, 컨텍스트 길이, 지원 파라미터, 입출력 형식을 조회하는 방법과 단일 모델 및 카테고리별 조회, 가장 저렴한 텍스트 모델 찾기 예시를 담았습니다. 호출 시 만나는 오류도 정리했습니다.

호출할 수 있는 모든 모델을 카테고리, 컨텍스트 길이, 모달리티, 지원 파라미터, USD 가격과 함께 나열합니다. 목록은 OpenAI의 GET /models 형식에 추가 필드를 더한 것이므로 client.models.list()가 그대로 동작합니다.

모델 목록 엔드포인트에는 API 키가 필요 없습니다. 응답은 5분 동안 캐시됩니다.

모델 목록 조회

GET https://api14.com/api/v1/models

쿼리 파라미터	설명
`category`	카테고리로 필터링합니다: `text`, `image`, `video`, `speech`, `transcription`, `audio`, `embeddings`, `rerank`, `decisions` 또는 `all`.
`output_modalities`	`category`의 별칭입니다.

curl https://api14.com/api/v1/models
curl "https://api14.com/api/v1/models?category=image"

응답

{
  "object": "list",
  "data": [
    {
      "id": "anthropic/claude-sonnet-4.5",
      "object": "model",
      "created": 1758672000,
      "owned_by": "anthropic",
      "name": "Anthropic: Claude Sonnet 4.5",
      "description": "Anthropic's most capable Sonnet model...",
      "category": "text",
      "context_length": 1000000,
      "architecture": {
        "input_modalities": ["text", "image", "file"],
        "output_modalities": ["text"]
      },
      "pricing": {
        "prompt": "0.000003",
        "completion": "0.000015",
        "input_cache_read": "0.0000003",
        "input_cache_write": "0.00000375"
      },
      "supported_parameters": ["tools", "tool_choice", "reasoning", "max_tokens", "temperature"],
      "endpoint": "/api/v1/chat/completions"
    }
  ]
}

필드	설명
`id`	`model`로 보낼 모델 ID(`provider/model` 형식). 모델 ID를 참고하세요.
`category`	주 카테고리. 호출할 엔드포인트를 결정합니다.
`pricing`	문자열로 표시된 USD 가격. 키 이름이 달리 나타내지 않는 한(`request`, `image`, 동영상 SKU) 토큰당 가격입니다. 실제로 지불하는 가격입니다.
`supported_parameters`	모델이 받는 요청 파라미터(`tools`, `reasoning`, `response_format`, ...).
`endpoint`	이 모델의 카테고리에 해당하는 게이트웨이 엔드포인트.

api14에서 활성화된 모델만 나열됩니다.

단일 모델 조회

GET https://api14.com/api/v1/models/{id}

curl https://api14.com/api/v1/models/openai/gpt-5-mini

같은 형식의 단일 모델 객체를 반환합니다. 변형 접미사는 기본 모델로 해석됩니다(openai/gpt-5-mini:nitro → openai/gpt-5-mini). 알 수 없거나 비활성화된 ID는 404 model_not_found를 반환합니다.

카테고리별 카탈로그

이 카탈로그에는 지원 해상도, 길이, 화면비, SKU별 동영상 가격 같은 추가 파라미터가 포함됩니다. 공개되어 있으며 키가 필요 없습니다.

curl https://api14.com/api/v1/images/models
curl https://api14.com/api/v1/videos/models
curl https://api14.com/api/v1/embeddings/models

예시: 가장 저렴한 텍스트 모델

curl -s "https://api14.com/api/v1/models?category=text" \
  | jq -r '.data | sort_by(.pricing.prompt | tonumber) | .[:5][] | "\(.id)  \(.pricing.prompt)"'

오류

상태	코드	발생 조건
404	`model_not_found`	알 수 없거나 비활성화된 모델에 대한 `GET /models/{id}`.
502	`upstream_unavailable`	프록시 카탈로그(`/images/models` 등)를 가져올 수 없습니다.

오류를 참고하세요.