Erreurs
Tous les codes de statut renvoyés par la passerelle, leurs causes réelles et les solutions.
Les erreurs renvoient JSON avec un type et un message lisible par un humain message. Les codes de statut suivent les conventions d’Anthropic et d’OpenAI.
{"type": "error", "error": {"type": "authentication_error", "message": "invalid api key"}}Codes de statut
| Code | Signification | Cause réelle la plus courante | Solution |
|---|---|---|---|
400 | Requête incorrecte | Absence de max_tokens dans Messages, ou un élément mal formé : messages tableau | Vérifiez le corps de la requête par rapport à Messages |
401 | Non authentifié | Clé envoyée dans le mauvais en-tête pour le format utilisé | x-api-key pour Messages, Bearer pour Chat Completions |
402 | Paiement requis | Solde épuisé ou forfait expiré | Recharger ou acheter un forfait |
403 | Accès interdit | Clé révoquée ou modèle non activé pour le compte | Créez une nouvelle clé ; vérifiez /v1/models |
404 | Introuvable | Erreur d’URL de base — généralement un élément dupliqué ou manquant : /v1 | Voir URL de base |
429 | Limite de débit atteinte | Trop de requêtes simultanées | Réessayez avec un délai exponentiel ; voir Limites de débit |
500 | Erreur de passerelle | Défaillance interne inattendue | Réessayez une fois ; si le problème persiste, contactez l’assistance en indiquant l’identifiant de la requête |
529 | Service en amont surchargé | Capacité du fournisseur, sans lien avec votre compte | Réessayez avec un délai croissant — le problème se résout généralement en quelques secondes |
Types d’erreurs
| type | Signification |
|---|---|
invalid_request_error | Le corps de la requête est mal formé ou un champ obligatoire est manquant |
authentication_error | Clé manquante, mal formée ou révoquée |
permission_error | La clé est valide, mais n’est pas autorisée à utiliser ce modèle |
not_found_error | Chemin inconnu ou identifiant de modèle inconnu |
rate_limit_error | Débit limité |
api_error | Défaillance interne |
overloaded_error | Capacité du service en amont épuisée |
Réessayer correctement
Nouvelle tentative 429, 500, 502, 503 et 529. Ne réessayez jamais aveuglément 400, 401, 402 ou 403 — la même requête échouera de la même manière et, pour les réponses partiellement générées, vous risquez de payer deux fois.
import time, httpx
def call(body, key, tries=4):
for i in range(tries):
r = httpx.post(class="s">"https://aiprimetech.io/v1/messages", json=body, timeout=120,
headers={class="s">"x-api-key": key,
class="s">"anthropic-version": class="s">"2023-06-01"})
if r.status_code in (429, 500, 502, 503, 529):
time.sleep(2 ** i) class=class="s">"c"># 1s, 2s, 4s, 8s
continue
r.raise_for_status()
return r.json()
raise RuntimeError(class="s">"upstream unavailable after retries")Ajoutez une variation aléatoire au délai d’attente en production. Des tentatives synchronisées provenant de nombreux processus de traitement transforment un incident passager en un afflux massif de requêtes vers le même service en amont.