Error

​

Error HTTP

API kami mengikuti format kode error HTTP yang dapat diprediksi:

• 400 - invalid_request_error: Ada masalah dengan format atau konten permintaan Anda. Kami juga dapat menggunakan jenis error ini untuk kode status 4XX lain yang tidak tercantum di bawah ini.

• 401 - authentication_error: Ada masalah dengan kunci API Anda.

• 403 - permission_error: Kunci API Anda tidak memiliki izin untuk menggunakan sumber daya yang ditentukan.

• 404 - not_found_error: Sumber daya yang diminta tidak ditemukan.

• 413 - request_too_large: Permintaan melebihi jumlah byte maksimum yang diizinkan.

• 429 - rate_limit_error: Akun Anda telah mencapai batas rate.

• 500 - api_error: Terjadi kesalahan tak terduga di dalam sistem Anthropic.

• 529 - overloaded_error: API Anthropic sementara kelebihan beban.

  Error 529 dapat terjadi ketika API Anthropic mengalami lalu lintas tinggi dari semua pengguna. Dalam kasus yang jarang terjadi, jika organisasi Anda mengalami peningkatan penggunaan yang tajam, Anda mungkin melihat jenis error ini. Untuk menghindari error 529, tingkatkan lalu lintas Anda secara bertahap dan pertahankan pola penggunaan yang konsisten.

Saat menerima respons streaming melalui SSE, ada kemungkinan error dapat terjadi setelah mengembalikan respons 200, dalam hal ini penanganan error tidak akan mengikuti mekanisme standar ini.

​

Bentuk Error

Error selalu dikembalikan sebagai JSON, dengan objek error level atas yang selalu menyertakan nilai type dan message. Sebagai contoh:

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "The requested resource could not be found."
  }
}

Sesuai dengan kebijakan versioning kami, kami dapat memperluas nilai-nilai dalam objek ini, dan ada kemungkinan bahwa nilai type akan bertambah seiring waktu.

​

ID permintaan

Setiap respons API menyertakan header request-id yang unik. Header ini berisi nilai seperti req_018EeWyXxfu5pfWkrYcMdjWG. Saat menghubungi dukungan tentang permintaan tertentu, harap sertakan ID ini untuk membantu kami menyelesaikan masalah Anda dengan cepat.

SDK resmi kami menyediakan nilai ini sebagai properti pada objek respons level atas, yang berisi nilai header x-request-id:

​

Permintaan panjang

Kami tidak merekomendasikan pengaturan nilai max_tokens yang besar tanpa menggunakan API Messages Streaming atau API Message Batches kami:

• Beberapa jaringan mungkin memutuskan koneksi idle setelah periode waktu tertentu, yang dapat menyebabkan permintaan gagal atau timeout tanpa menerima respons dari Anthropic.
• Jaringan berbeda dalam keandalan; API Message Batches kami dapat membantu Anda mengelola risiko masalah jaringan dengan memungkinkan Anda melakukan polling untuk hasil daripada memerlukan koneksi jaringan yang tidak terputus.

Jika Anda membangun integrasi API langsung, Anda harus menyadari bahwa pengaturan TCP socket keep-alive dapat mengurangi dampak timeout koneksi idle pada beberapa jaringan.

SDK kami akan memvalidasi bahwa permintaan API Messages non-streaming Anda tidak diharapkan melebihi timeout 10 menit dan juga akan mengatur opsi socket untuk TCP keep-alive.