Contrat d'erreur#
Les erreurs utilisent { error: { message, type, code } }. Ne réessayez jamais indéfiniment.
| HTTP | Code | Que faire |
|---|---|---|
| 400 | invalid_request | Corrigez le JSON, les champs requis ou les limites de jetons. |
| 401 | invalid_api_key | Vérifiez la clé et l'en-tête Bearer ; faites-la pivoter si elle est révoquée. |
| 402 | insufficient_balance | Vérifiez le rechargement qualifiant confirmé, le crédit disponible et le budget de clé ; chaque nouveau rechargement doit être d'au moins 100 USD. |
| 403 | model_not_allowed | Mettez à jour la liste d'autorisation de la clé ou choisissez un modèle autorisé. |
| 404 | model_not_found | Récupérez /v1/models et utilisez un identifiant exact. |
| 409 | pending_reconciliation | Attendez la réconciliation de l'utilisation avant de réessayer l'opération. |
| 413 | request_too_large | Divisez l'entrée ou utilisez un contexte plus grand. |
| 422 | unsupported_feature | Choisissez un déploiement qui prend en charge la fonctionnalité. |
| 429 | quota_exceeded | Respectez Retry-After s'il est fourni et utilisez des tentatives limitées ; aucun quota d'essai gratuit public n'est offert. |
| 502 | upstream_error | Réessayez avec un backoff limité ; vérifiez le statut. |
| 503 | service_unavailable | Vérifiez le statut du service et la disponibilité du modèle avant de réessayer. |
Éviter le travail en double#
Ne supposez pas qu'une requête d'inférence était gratuite parce que la connexion a été interrompue. Vérifiez vos relevés d'utilisation. Les dépôts sont indépendamment idempotents par identité de transaction du fournisseur.
Obtenir de l'aide#
Utilisez le guide d'assistance pour diagnostiquer l'étape qui a échoué et préparer un rapport avec le code d'erreur, l'heure UTC, le modèle et une reproduction synthétique. L'outil de rapport local n'envoie pas de ticket. Gardez les identifiants et le contenu client hors du rapport.
Exemple de demande
curl https://weightsapi.com/v1/chat/completions \
-H "Authorization: Bearer $WEIGHTSAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Qwen/Qwen3-32B",
"messages": [
{
"role": "user",
"content": "Hello!"
}
],
"stream": true
}'