Erreurs et limites de débit

Format des erreurs, codes et limites de débit.

Format des erreurs#

Un statut HTTP et un JSON avec un code stable:

JSON

{

  "error": {

    "code": "payment_required",

    "message": "no credit left: buy credits to keep searching",

    "details": { "balance_usd": 0.0019 }

  }

}

details: seulement s'il ajoute quelque chose (balance_usd avec 402, retry_after_s avec 429).
Testez code, pas message, qui peut changer.
Champ du mauvais type, hors bornes ou inconnu (max_output_tokens sous 1, un champ mal orthographié): 422 avant exécution, avec le corps de validation standard:

JSON

{ "detail": [ { "loc": ["body", "k"], "msg": "Input should be less than or equal to 100", "type": "less_than_equal" } ] }

Codes d'erreur#

HTTP	`code`	Sens	Réessayer
400	`invalid_request`	requête impossible telle quelle (préréglage inconnu, ni `file` ni `source`, envoi trop gros, nom de dossier pris...); voir `message`	non
400	`fetch_blocked`	URL refusée: réseau privé, chemin du serveur, connecteur désactivé; utilisez une URL publique ou envoyez le fichier	non
401	`unauthorized`	clé absente, invalide, révoquée ou expirée; lien de partage invalide ou expiré	non
402	`payment_required`	crédits insuffisants ou budget mensuel de la clé épuisé	après achat de crédits ou hausse du budget de la clé
403	`forbidden`	lien de partage hors de son run, point d'accès réservé aux opérateurs	non
404	`not_found`	inexistant, ou hors de votre espace de travail (même réponse)	non
413	`too_large`	fichier récupéré par URL trop gros	non
415	`unsupported_source`	spécification sans connecteur, ou type de fichier non pris en charge (Formats)	non
422		champ du mauvais type ou hors bornes	non
429	`rate_limited`	trop de requêtes (Limites de débit)	après `retry-after` secondes
500	`internal_error`	erreur inattendue; si elle persiste, signalez le `x-request-id`	oui
502	`fetch_failed`	origine d'une source injoignable (panne, refus, délai)	oui, plus tard
502	`provider_error`	un service utilisé a échoué (`429` s'il est saturé)	oui, délai croissant
503	`provider_unavailable`	service occupé ou non configuré (les paiements, par exemple)	oui, plus tard

Erreurs en streaming: Streaming. Facturation d'une requête en échec ou renvoyée: Tarifs.

Limites de débit#

	Défaut
Requêtes par minute	120 par clé, ou son `rate_limit_per_minute` (fixé à la création)
Compté par	clé d'API, sinon utilisateur connecté ou lien de partage
`GET /v1/imports`, `GET /v1/imports/{id}`	allocation séparée, 600 par minute au moins

Chaque requête compte, streaming compris. Au-delà: 429, en-tête retry-after: 60.

JSON

{ "error": { "code": "rate_limited", "message": "rate limit exceeded (120 requests/minute)", "details": { "retry_after_s": 60 } } }