Anthropic API 404 not_found_error: "model: …" — mengapa nama model yang ada tetap menghasilkan 404

Bagian yang membingungkan dari 404 ini adalah model tersebut biasanya memang ada — di dokumentasi Anthropic, dalam artikel blog, atau di kode kuartal lalu. Namun model itu tidak ada dalam daftar yang boleh diakses oleh kunci API Anda hari ini.

Error

respons (HTTP 404)

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

Ringkasan penyebab dan perbaikan

Penyebab	Perbaikan
Snapshot bertanggal yang sudah dihentikan	Snapshot tidak digunakan lagi sesuai jadwal yang dipublikasikan, lalu berhenti di-resolve. Beralihlah ke snapshot yang masih berlaku.
Alias yang tidak pernah ada	`claude-3-5-sonnet` adalah keluarga model, bukan id yang dapat dipanggil. ID Anthropic menyertakan versi atau sufiks tanggal.
Modelnya nyata, tetapi tidak diaktifkan untuk akun Anda	Model terbaru dapat dibatasi berdasarkan tingkat akun. 404 tidak dapat dibedakan dari salah ketik — periksa endpoint models, bukan dokumentasi.
Nama model OpenAI pada endpoint Anthropic	`gpt-4o` di api.anthropic.com adalah model yang tidak ditemukan, bukan kesalahan perutean. Gunakan gateway jika Anda menginginkan satu endpoint untuk keduanya.

Tanyakan kepada API, bukan dokumentasi

Dokumentasi menjelaskan katalog; endpoint models menjelaskan katalog Anda. Saat keduanya berbeda, endpoint-lah yang benar. Apa pun yang tidak ada dalam daftar ini akan menghasilkan 404, betapapun mutakhirnya tampilan di tempat lain.

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

Tetapkan pin dengan sengaja, lakukan upgrade dengan sengaja

Hard-code snapshot bertanggal memberi reproduktibilitas sekaligus 404 di masa depan pada tanggal yang tidak Anda pilih. Membaca model id dari konfigurasi berarti perbaikannya cukup berupa nilai saat deploy, bukan perubahan kode — dan sakelar yang sama memungkinkan failover ketika model sibuk, bukan ketika model hilang.

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"}],
)

Bedakan 404 dari 400 dan 403

404 berarti nama tersebut tidak me-resolve ke apa pun. 400 berarti namanya benar, tetapi permintaannya tidak benar (parameter salah atau konten tidak valid). 403 berarti modelnya ada, tetapi Anda tidak boleh menggunakannya. Hanya 404 yang diperbaiki dengan mengubah string model.

Jika Anda melakukan panggilan melalui Kunavo

Katalog Kunavo adalah daftar yang dikembalikan endpoint /v1/models, dan setiap id di dalamnya dapat dipanggil dengan kunci yang memiliki dana — tidak ada pembatasan model per akun, sehingga penyebab "nyata tetapi tidak diaktifkan untuk Anda" di atas tidak berlaku. Karena endpoint yang sama menyediakan nama Claude dan keluarga GPT, id OpenAI juga bukan kesalahan endpoint; id tersebut hanya dirutekan. Penghentian model tetap terjadi di upstream, dan ketika model ditarik, id-nya dialihkan atau didokumentasikan, bukan dibiarkan diam-diam menghasilkan 404. ID saat ini dan tarif per tokennya tersedia di daftar harga Claude API.

Pertanyaan umum

Apakah 404 pernah merupakan error sementara?

Tidak. Berbeda dari 429, 500, dan 529, mencoba ulang 404 dengan string model yang sama hanya akan gagal lagi. Ubah string tersebut atau berhenti.

Bagaimana saya mengetahui kapan sebuah snapshot dihentikan?

Anthropic menerbitkan tanggal penghentian untuk snapshot bertanggal. Jika Anda melakukan pin pada snapshot, jadwal tersebut menjadi item kalender; jika Anda membaca id dari konfigurasi, perubahannya hanya satu baris.

Mengapa kunci kolega saya berfungsi dengan nama yang sama?

Ketersediaan model dapat berbeda berdasarkan tingkat akun. Bandingkan kedua respons /v1/models — perbedaan itulah jawabannya.

Panduan terkait

Detail semantik error lainnya tersedia di referensi error; mendapatkan kunci hanya perlu satu menit melalui pendaftaran dan panduan autentikasi.