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.
  • 413 - request_too_large: Permintaan melebihi jumlah byte maksimum yang diizinkan.
  • 429 - rate_limit_error: Akun Anda telah mencapai batas laju.
  • 500 - api_error: Terjadi kesalahan tak terduga di dalam sistem Anthropic.
  • 529 - overloaded_error: API Anthropic sedang kelebihan beban sementara.

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. Contohnya:

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

Sesuai dengan kebijakan versi kami, kami dapat memperluas nilai-nilai dalam objek-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.