Anthropic API 404 not_found_error: "model: …" — var olan bir model adı neden yine de 404 döner

Bu 404'ü kafa karıştırıcı yapan şey, modelin genellikle gerçekten var olmasıdır — Anthropic belgelerinde, bir blog yazısında veya geçen çeyreğin kodunda. Ancak bugün API anahtarınızın erişebileceği listede bulunmuyor olabilir.

Hata

yanıt (HTTP 404)

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

Nedenler ve çözümler özeti

Neden	Çözüm
Kullanımdan kaldırılmış tarihli bir anlık görüntü	Anlık görüntüler yayımlanmış bir takvime göre kullanımdan kaldırılır ve ardından çözülmeyi bırakır. Güncel bir sürüme geçin.
Hiç var olmamış bir takma ad	`claude-3-5-sonnet` çağrılabilir bir kimlik değil, bir model ailesidir. Anthropic kimlikleri bir sürüm veya tarih son eki taşır.
Model gerçek ama hesabınız için etkin değil	En yeni modeller katmana göre kısıtlanabilir. 404, yazım hatasından ayırt edilemez — belgeleri değil, models uç noktasını kontrol edin.
Anthropic uç noktasında kullanılan bir OpenAI model adı	api.anthropic.com üzerindeki `gpt-4o`, yönlendirme hatası değil, bulunamayan bir modeldir. Tek bir uç noktada her ikisini de kullanmak istiyorsanız bir ağ geçidi kullanın.

Belgelere değil, API'ye sorun

Belgeler kataloğu, models uç noktası ise sizin kataloğunuzu açıklar. İkisi uyuşmadığında doğru olan uç noktadır. Bu listede bulunmayan her şey, başka yerde ne kadar güncel görünürse görünsün 404 döner.

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"'

Bilinçli şekilde sabitleyin, bilinçli şekilde yükseltin

Tarihli bir anlık görüntüyü sabit kodlamak yeniden üretilebilirlik sağlar; ancak seçmediğiniz bir tarihte gelecekte 404 almanıza yol açar. Model kimliğini yapılandırmadan okumak, düzeltmeyi kod değişikliği değil dağıtım zamanında verilen bir değer haline getirir — ayrıca bir model eksik olduğunda değil meşgul olduğunda yük devretmenizi sağlayan aynı geçişi mümkün kılar.

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 ve 403'ten ayırın

404, adın hiçbir şeye çözümlenmediği anlamına gelir. 400, adın doğru fakat isteğin hatalı olduğu anlamına gelir (yanlış parametre, bozuk içerik). 403, modelin var olduğu ancak onu kullanmanıza izin verilmediği anlamına gelir. Yalnızca 404, model dizesi değiştirilerek düzeltilir.

Kunavo üzerinden çağrı yapıyorsanız

Kunavo'nun kataloğu, /v1/models uç noktasının döndürdüğü listedir ve listedeki her kimlik, finanse edilmiş herhangi bir anahtarla çağrılabilir — hesap başına model kısıtlaması yoktur; bu nedenle yukarıdaki "gerçek ama sizin için etkin değil" nedeni burada geçerli değildir. Aynı uç nokta Claude ve GPT ailesi adlarını sunduğundan, bir OpenAI kimliği de yanlış uç nokta hatası değildir; yalnızca yönlendirilir. Kullanımdan kaldırmalar yine de üst tarafta gerçekleşir ve bir model çekildiğinde kimliği sessizce 404'e bırakılmak yerine yönlendirilir veya belgelenir. Güncel kimlikler ve token başına ücretleri burada yer alır: Claude API fiyat listesi.

Sık sorulan sorular

404 hiç geçici bir hata olur mu?

Hayır. 429, 500 ve 529'un aksine, aynı model dizesiyle 404'ü yeniden denemek yalnızca tekrar başarısız olur. Dizeyi değiştirin veya durun.

Bir anlık görüntünün ne zaman kullanımdan kaldırılacağını nasıl bilebilirim?

Anthropic, tarihli anlık görüntüler için kullanımdan kaldırma tarihlerini yayımlar. Anlık görüntüleri sabitlerseniz bu takvimde yer alması gereken bir tarihtir; kimliği yapılandırmadan okuyorsanız tek satırlık bir değişikliktir.

Meslektaşımın anahtarı neden aynı adla çalışıyor?

Model kullanılabilirliği hesap katmanına göre değişebilir. İki /v1/models yanıtını karşılaştırın — aradaki fark cevaptır.

İlgili kılavuzlar

Hata anlamlarına ilişkin daha fazla bilgi hata referansı bölümünde; anahtar almak kayıt ve kimlik doğrulama kılavuzu üzerinden bir dakika sürer.