Dépannage
Index par symptôme : trouvez ce que vous observez et accédez directement à la cause.
Vérifiez l’accès avant de réessayer
- Vérifiez que le droit d’accès prévu est actif et notez sa date d’expiration.
- Vérifiez que la clé utilise le groupe prévu. Les forfaits Claude à durée limitée utilisent Claude Unlimited; l’accès à Codex est distinct.
- Listez les modèles avec cette même clé, sélectionnez un identifiant renvoyé et envoyez une petite requête.
Utilisez Modèles et groupes de clés ou la liste de vérification de la configuration de l’agent si vous ne savez pas quelle étape a échoué.
Rien ne fonctionne
Vérifiez les éléments de base avant de déboguer quoi que ce soit d’autre :
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"Après une réponse réussie à la requête de liste des modèles, vérifiez que le modèle sélectionné figure dans la liste et envoyez une petite requête de génération. La génération peut encore échouer en raison de la disponibilité du modèle, des droits d’accès, des limites ou de la configuration du client.
Par symptôme
| Symptôme | Cause probable | Solution |
|---|---|---|
404 à chaque appel | L’URL de base présente une mauvaise /v1 gestion | URL de base |
401 avec une clé que vous venez de créer | En-tête incorrect pour le format, ou espace final | Authentification |
402 | Aucun crédit, ou forfait expiré | Recharger · Forfaits |
400 max_tokens | Messages exige max_tokens; Chat Completions ne l’exige pas | Messages |
model_not_found | Identifiant incorrect, mauvais groupe de clés ou modèle indisponible pour cette clé | Modèles et groupes de clés |
| La connexion au flux s’établit, mais ne renvoie rien | Analyse de la structure des événements de l’autre format | Diffusion en continu |
| Réponse interrompue au milieu d’une phrase | stop_reason: max_tokens | Augmentez max_tokens |
| Fonctionne avec curl, mais échoue avec le SDK | Le SDK ajoute son propre chemin à votre URL de base | URL de base |
| L’utilisation n’apparaît pas dans le tableau de bord | Requêtes envoyées avec une autre clé ou vers un autre point de terminaison | Vérifiez ANTHROPIC_API_KEY n’est pas défini — Claude Code |
Fréquent 429 | Parallélisme de l’agent trop élevé | Limites de débit |
| Facture plus élevée que prévu | Augmentation du contexte au fil des tours | Gestion du contexte |
Lire le corps de l’erreur
Le code de statut indique la catégorie du problème ; les error.type et error.message champs indiquent lequel. Journalisez le corps entier — un 400 par "missing max_tokens" et un 400 par "invalid role" nécessitent des corrections complètement différentes.
Toujours bloqué
Contactez support@aiprimetech.io avec le point de terminaison, l’identifiant du modèle, le code de statut et le corps de l’erreur. N’incluez jamais votre clé API — si vous l’avez déjà collée quelque part, révoquez-la d’abord.