Kesalahan HTTP

API kami mengikuti format kode kesalahan HTTP yang dapat diprediksi:

  • 400 - invalid_request_error: Ada masalah dengan format atau konten permintaan Anda. Kami juga dapat menggunakan jenis kesalahan ini untuk kode status 4XX lainnya 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.
  • 429 - rate_limit_error: Akun Anda telah mencapai batas laju.
  • 500 - api_error: Kesalahan tak terduga telah terjadi di dalam sistem Anthropic.
  • 529 - overloaded_error: API Anthropic sementara kelebihan beban.

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

Bentuk Kesalahan

Kesalahan selalu dikembalikan sebagai JSON, dengan objek error tingkat atas yang selalu menyertakan nilai type dan message. Misalnya:

JSON
{
  "type": "error",
  "error": {
    "type": "not_found_error", 
    "message": "Sumber daya yang diminta tidak dapat ditemukan."
  }
}

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