Model kimlikleri taşınabilir değildir: api.anthropic.com tarihli kimlikler ister, Gemini kendi sürüm dizelerini ister ve her ağ geçidi slug'ları tanımlar. Buradaki 404, "bu ana bilgisayarın tam olarak bu dizeyle bir modeli yok" demektir; çözüm her zaman uç noktaya ne sunduğunu sormaktır.
Hata
{
"error": {
"type": "model_not_found",
"message": "The model 'claude-sonnet' does not exist or you do not have access to it.",
"code": "model_not_found"
}
}Nedenler ve çözümler özeti
| Neden | Çözüm |
|---|---|
| Başka bir ana bilgisayardan alınmış model kimliği | Her API'nin kendi ad alanı vardır; kimlikleri blog yazılarından değil, uç noktanın kendi model listesinden kopyalayın. |
| Kullanımdan kaldırılmış/yeniden adlandırılmış sürüm | Sağlayıcılar tarihli anlık görüntüleri kullanımdan kaldırır; güncel bir kimliğe sabitleyin ve kullanımdan kaldırma duyurularını takip edin. |
| Yazım hatalı veya kesilmiş slug | claude-sonnet hiçbir yerde bir model değildir; tam dizeler önemlidir. |
| Model mevcut ancak anahtarınız/planınız için devre dışı | Bazı ana bilgisayarlar modelleri plana göre kısıtlar; liste uç noktası SİZİN anahtarınızın çağırabildiği modelleri gösterir. |
Modelleri çağırdığınız uç noktadan listeleyin
GET /v1/models, OpenAI uyumlu herhangi bir ana bilgisayarda gerçeğin kaynağıdır; anahtarınızın kullanabileceği kimlikleri tam olarak döndürür:
curl -s https://api.kunavo.com/v1/models \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
| python3 -c "import json,sys; print('\n'.join(m['id'] for m in json.load(sys.stdin)['data']))"Modelleri sabit kodlamak yerine çalışma zamanında çözümleyin
Kataloglar değişir (yeni anlık görüntüler, kullanımdan kaldırmalar). Başlangıçta model listesini çözümleyin, yapılandırılmış slug'ları geri dönüş seçeneğiyle tercih edin ve yapılandırılmış bir slug /v1/models içinden kaybolduğunda üretimde 404 oluşmadan uyarı verin.
Kunavo üzerinden çağrı yapıyorsanız
Kunavo, GET /v1/models adresinde model başına meta verilerle listelenen kararlı, insan tarafından okunabilir slug'lar (claude-sonnet-5, gpt-5-6-terra, claude-fable-5) kullanır; kullanımdan kaldırılan slug'lar, bağlantıların bozulmaması için sitenin model sayfalarında haleflerine 301 yönlendirmesi yapar. Liste uç noktası yetkilidir; llms.txt de bunu okuyan her ajana aynı şeyi söyler.
Sık sorulan sorular
Aynı model kimliği neden bir API'de çalışıp diğerinde 404 veriyor?
Çünkü kimlikler ana bilgisayar başına ad alanına sahiptir: Anthropic'in tarihli kimlikleri, Gemini'nin sürümlü adları ve her ağ geçidinin slug'ları, ilişkili modeller için farklı dizelerdir. Her zaman hedef uç noktanın kendi model listesinden kopyalayın.
Modelin kullanımdan kaldırılmasına nasıl hazırlanırım?
Başlangıçta /v1/models'i çözümleyin, model kimliğini kodda değil yapılandırmada tutun, bir geri dönüş zinciri tanımlayın ve yapılandırılmış kimlik kaybolduğunda kendinize bildirim gönderin; böylece üretim 404'ü bir yapılandırma değişikliğine dönüşü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.