Anthropic API 404 not_found_error: "model: …" — 존재하는 모델 이름인데도 404가 발생하는 이유

이 404가 혼란스러운 이유는 모델이 대개 실제로 존재하기 때문입니다 — Anthropic 문서나 블로그 글, 지난 분기의 코드에는 있을 수 있습니다. 하지만 오늘 귀하의 API 키가 접근할 수 있는 목록에는 존재하지 않습니다.

오류

응답(HTTP 404)

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "model: claude-3-5-sonnet"
  }
}

원인과 해결 방법 한눈에 보기

원인	해결 방법
폐기된 날짜 지정 스냅샷	스냅샷은 공개된 일정에 따라 더 이상 사용되지 않게 된 후 해석이 중단됩니다. 최신 스냅샷으로 이동하세요.
처음부터 존재하지 않았던 별칭	`claude-3-5-sonnet`은 호출 가능한 ID가 아니라 제품군 이름입니다. Anthropic ID에는 버전 또는 날짜 접미사가 포함됩니다.
모델은 실제로 존재하지만 귀하의 계정에서 활성화되지 않음	최신 모델은 등급별로 제한될 수 있습니다. 이 404는 오타와 구분되지 않으므로 문서가 아니라 models 엔드포인트를 확인하세요.
Anthropic 엔드포인트에 OpenAI 모델 이름 사용	api.anthropic.com의 `gpt-4o`는 라우팅 오류가 아니라 누락된 모델입니다. 두 서비스를 하나의 엔드포인트에서 사용하려면 게이트웨이를 사용하세요.

문서가 아니라 API에 물어보세요

문서는 카탈로그를 설명하지만 models 엔드포인트는 귀하의 카탈로그를 설명합니다. 둘이 다르면 엔드포인트가 올바릅니다. 이 목록에 없는 것은 다른 곳에서 아무리 최신처럼 보여도 404가 발생합니다.

list-models.sh

curl -s https://api.anthropic.com/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  | grep '"id"'

의도적으로 고정하고, 의도적으로 업그레이드하세요

날짜가 지정된 스냅샷을 하드코딩하면 재현성을 얻는 대신 원하지 않은 날짜에 미래의 404를 맞게 됩니다. 구성에서 모델 ID를 읽으면 수정이 코드 변경이 아닌 배포 시 값 변경이 됩니다. 모델이 누락된 것이 아니라 바쁠 때 장애 조치를 할 수 있게 해 주는 것도 동일한 전환입니다.

model_config.py

import os

# One place to change when a snapshot retires.
MODEL = os.environ.get("LLM_MODEL", "claude-sonnet-5")

resp = client.chat.completions.create(
    model=MODEL,
    messages=[{"role": "user", "content": "ping"}],
)

404를 400 및 403과 구분하는 방법

404는 이름이 아무것도 가리키지 않는다는 뜻입니다. 400은 이름은 올바르지만 요청이 잘못되었다는 뜻입니다（잘못된 매개변수, 형식이 잘못된 콘텐츠 등）. 403은 모델이 존재하지만 사용할 수 없다는 뜻입니다. 모델 문자열을 바꿔 해결할 수 있는 것은 404뿐입니다.

Kunavo를 통해 호출하는 경우

Kunavo의 카탈로그는 /v1/models 엔드포인트가 반환하는 목록이며, 목록의 모든 ID는 자금이 충전된 모든 키에서 호출할 수 있습니다. 계정별 모델 제한이 없으므로 위에서 말한 "실제로 존재하지만 귀하에게 활성화되지 않음"이라는 원인은 발생하지 않습니다. 동일한 엔드포인트가 Claude 및 GPT 제품군 이름을 모두 제공하므로 OpenAI ID도 잘못된 엔드포인트 문제가 아니라 그대로 라우팅됩니다. 다만 업스트림에서 모델이 폐기될 수 있으며, 모델이 철회되면 해당 ID는 조용히 404를 반환하는 대신 리디렉션되거나 문서화됩니다. 현재 ID와 토큰별 요금은 다음에서 확인할 수 있습니다 Claude API 가격표.

자주 묻는 질문

404가 일시적인 오류일 수도 있나요?

아니요. 429, 500 및 529와 달리 동일한 모델 문자열로 404를 재시도하면 다시 실패할 뿐입니다. 문자열을 변경하거나 중단하세요.

스냅샷이 언제 폐기되는지 어떻게 알 수 있나요?

Anthropic은 날짜가 지정된 스냅샷의 사용 중단 날짜를 공개합니다. 스냅샷을 고정한다면 해당 일정은 달력에 등록해야 할 항목이고, 구성에서 ID를 읽는다면 한 줄만 변경하면 됩니다.

동료의 키는 같은 이름으로 작동하는데 왜 제 키는 안 되나요?

모델 사용 가능 여부는 계정 등급에 따라 다를 수 있습니다. 두 /v1/models 응답을 비교하면 그 차이가 답입니다.