Erreurs et limites

L’erreur utilise le format de l’API appelée : l’objet error pour OpenAI, {"type": "error", "error": {...}} pour Anthropic et error avec les champs status et details pour Gemini. Les SDK les reconnaissent donc comme des erreurs API ordinaires.

• error.code et error.reason — classe d’erreur figurant dans le tableau ci-dessous ; les deux champs ont la même valeur. error.type — valeur standard du format (par exemple, invalid_request_error ou server_error).
• error.request_id (pour Anthropic, request_id au premier niveau), l’en-tête X-Request-ID et la fin du message contiennent l’identifiant de la requête.
• Pour Gemini, la classe se trouve dans error.details : ErrorInfo.reason — le même code en majuscules (par exemple, MODEL_OVERLOADED), domain — ailoot.ai; l’identifiant de la requête se trouve dans RequestInfo.requestId.
• Au format Gemini, une erreur 5xx qui ne doit pas être relancée automatiquement et result_pending_check sont renvoyés avec le statut 409 et status ABORTED : les SDK et CLI Gemini ne les relancent donc pas eux-mêmes. La classe d’erreur se trouve dans ErrorInfo.reason (par exemple, MODEL_TIMEOUT ou RESULT_PENDING_CHECK).
• La réponse au format OpenAI contient également les champs de premier niveau code et message — pour les anciens clients.

{
  "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"
      }
    ]
  }
}

Les codes relatifs aux réponses du modèle et à la vérification du résultat (502, 503 et 504) désignent désormais le modèle ou la requête : model_unavailable, model_timeout, invalid_model_response, incomplete_response, charge_not_confirmed et result_pending_check. Si votre code compare error.code aux anciennes valeurs, remplacez-les par les codes du tableau ; pour connaître la correspondance entre anciens et nouveaux codes, contactez l’assistance.

• Vérifiez d’abord X-Should-Retry : en cas de false, result_pending_check ou model_timeout ne relancez pas automatiquement la requête. Recherchez le Request ID dans l’historique de votre espace client : vous y trouverez le résultat et le débit.
• Une nouvelle tentative est sûre lorsque vous recevez X-Should-Retry : true : attendez Retry-After secondes. Un code 5xx ne suffit pas : le résultat peut déjà exister. Vérifiez d’abord l’historique dans l’espace client ou contactez l’assistance en indiquant le Request ID. C’est particulièrement important pour les images, les vidéos, la musique et les longues étapes d’agents.
• Une nouvelle tentative n’aidera pas : 400, 401, 402, 403, 404 : corrigez d’abord la requête, la clé ou le solde.

La fréquence et le nombre de requêtes simultanées sont limités pour votre compte dans son ensemble, et non pour chaque clé. Un dépassement entraîne une réponse 429 rate_limit_exceeded avec l’en-tête Retry-After: 10. Si le modèle lui-même est surchargé, une réponse 503 est renvoyée avec model_overloaded avec Retry-After: 30. Pour un volume plus élevé, contactez l’assistance.

Les plafonds de dépenses se définissent pour chaque clé : plafond global, erreur 402 api_key_quota_exhausted; fenêtres de 5 heures, 1 jour et 7 jours, erreur 429 usage_limit_reached. En savoir plus : Clés et adresse de l’API.

Vous pouvez consulter la liste des modèles même avec un solde nul ; pour générer, le solde doit couvrir la réservation. Les modèles NVIDIA, Nemotron et d’autres, passent par une file d’attente commune : en cas de forte charge, la réponse peut arriver plus tard ou une erreur « modèle temporairement surchargé » est renvoyée avec l’en-tête Retry-After. Réessayez après le délai indiqué. Les prix figurent dans le catalogue et la facturation suit les mêmes règles que pour les autres modèles.

Le modèle fixe les limites de taille : le contexte, soit le nombre de tokens que vous pouvez envoyer, et la longueur maximale de réponse. Elles figurent dans le catalogue.