Ralat dan had

Ralat diterima dalam format API yang anda panggil: objek error untuk OpenAI, {"type": "error", "error": {...}} untuk Anthropic dan error dengan medan status dan details untuk Gemini. Oleh itu, SDK mengenalinya sebagai ralat API biasa.

• error.code dan error.reason — kelas ralat daripada jadual di bawah; kedua-duanya sama. error.type — nilai standard bagi format (contohnya, invalid_request_error atau server_error).
• error.request_id (dalam Anthropic — request_id pada peringkat teratas), pengepala X-Request-ID dan penghujung teks mesej — pengecam permintaan.
• Dalam Gemini, kelas terdapat dalam error.details: ErrorInfo.reason — kod yang sama dalam huruf besar (contohnya, MODEL_OVERLOADED), domain — ailoot.ai; pengecam permintaan terdapat dalam RequestInfo.requestId.
• Dalam format Gemini, ralat 5xx yang tidak boleh dicuba semula secara automatik dan result_pending_check diterima dengan status 409 dan status ABORTED: dengan cara ini, Gemini SDK dan CLI tidak mengulanginya sendiri. Kelas ralat terdapat dalam ErrorInfo.reason (contohnya, MODEL_TIMEOUT atau RESULT_PENDING_CHECK).
• Respons berformat OpenAI turut mengandungi medan peringkat teratas code dan message — untuk klien lama.

{
  "code": "API_KEY_REQUIRED",
  "error": {
    "code": "invalid_api_key",
    "message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer <key>\". Request ID: 3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6.",
    "param": null,
    "reason": "invalid_api_key",
    "request_id": "3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6",
    "type": "invalid_request_error"
  },
  "message": "No API key was sent with the request. Nothing was charged. …"
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "reason": "invalid_api_key",
    "message": "… Nothing was charged. … Request ID: 94ed3e31-4373-41ce-bf8a-0d1ed3f7235e."
  },
  "request_id": "94ed3e31-4373-41ce-bf8a-0d1ed3f7235e"
}

{
  "error": {
    "code": 401,
    "status": "UNAUTHENTICATED",
    "message": "The API key is not valid. Nothing was charged. … Request ID: e7aa743b-9d0d-4064-b206-2562609f545b.",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_API_KEY",
        "domain": "ailoot.ai",
        "metadata": {
          "code": "invalid_api_key",
          "reason": "invalid_api_key",
          "request_id": "e7aa743b-9d0d-4064-b206-2562609f545b"
        }
      },
      {
        "@type": "type.googleapis.com/google.rpc.RequestInfo",
        "requestId": "e7aa743b-9d0d-4064-b206-2562609f545b"
      }
    ]
  }
}

Kod respons model dan semakan hasil (502, 503 dan 504) kini merujuk kepada model atau permintaan: model_unavailable, model_timeout, invalid_model_response, incomplete_response, charge_not_confirmed dan result_pending_check. Jika kod anda membandingkan error.code dengan nilai lama, gantikannya dengan kod dalam jadual; padanan antara kod lama dan baharu boleh diperoleh daripada sokongan.

• Semak X-Should-Retry terlebih dahulu: jika nilainya false, result_pending_check atau model_timeout jangan cuba semula secara automatik. Cari Request ID dalam sejarah panel pengguna: hasil dan caj dipaparkan di situ.
• Percubaan semula selamat apabila X-Should-Retry: true diterima: tunggu Retry-After saat. Untuk 5xx, kod sahaja tidak mencukupi: hasil mungkin sudah wujud. Semak sejarah dalam panel pengguna terlebih dahulu atau hubungi sokongan dengan Request ID. Ini amat penting untuk imej, video, muzik dan langkah ejen yang panjang.
• Percubaan semula tidak membantu: 400, 401, 402, 403, 404 — betulkan permintaan, kunci atau baki terlebih dahulu.

Kadar dan bilangan permintaan serentak dihadkan untuk seluruh akaun anda, bukan setiap kunci secara berasingan. Jika had dilampaui, respons 429 diterima rate_limit_exceeded dengan pengepala Retry-After: 10. Jika model itu sendiri terlebih beban — 503 model_overloaded dengan Retry-After: 30. Jika anda memerlukan beban yang lebih tinggi, hubungi sokongan.

Had perbelanjaan ditetapkan pada kunci: jumlah had — 402 api_key_quota_exhausted, tetingkap 5 jam, 1 hari dan 7 hari — 429 usage_limit_reached. Maklumat lanjut — Kunci dan alamat API.

Senarai model boleh diminta walaupun baki sifar; penjanaan memerlukan baki untuk rizab. Model NVIDIA (Nemotron dan model lain) menggunakan baris gilir bersama: ketika beban tinggi, respons mungkin tiba lebih lewat atau ralat “model terlebih beban buat sementara waktu” diterima dengan pengepala Retry-After — cuba semula selepas tempoh yang dinyatakan. Harga terdapat dalam katalog, dan caj dikenakan seperti model lain.

Had saiz ditentukan oleh model: konteks (bilangan token yang boleh dihantar) dan panjang maksimum respons. Had ini dinyatakan dalam katalog.