Documentation

Erreurs / Limites de requêtes

Erreurs

Les erreurs HTTP contiennent un objet error avec un code (code) et un message (message). Une tâche acceptée avec succès peut toujours échouer ultérieurement ; interrogez régulièrement la tâche ou configurez un webhook pour suivre son statut.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

HTTP	Champ	Action recommandée
400	`invalid_request`	Corrigez le JSON, le prompt manquant, la plage des paramètres ou l'URL du média avant de soumettre à nouveau.
401	`invalid_api_key`	Vérifiez votre jeton Bearer ainsi que l'état d'activation de votre clé API.
402	`insufficient_credits`	Ajoutez des crédits ou réduisez le coût estimé de la tâche. La réponse peut indiquer le solde requis et votre solde disponible.
403	`forbidden`	Veuillez vérifier la restriction au niveau du compte décrite dans le message d'erreur.
404	`not_found`	Vérifiez l'identifiant de la tâche et assurez-vous que la clé API utilisée appartient bien au propriétaire de la tâche.
429	`rate_limited`	Patientez durant l'intervalle indiqué par l'en-tête Retry-After avant de soumettre une nouvelle requête.
500	`internal_error`	Examinez le message d'erreur et les journaux de l'API. Réessayez avec modération ; le renvoi d'une requête de création peut générer une nouvelle tâche facturable.

Limites de requêtes

Création de tâches : chaque clé API permet par défaut jusqu'à 100 requêtes par minute. Il n'est actuellement pas possible de personnaliser ces limites de débit.

Consultation de tâches : chaque clé API permet par défaut jusqu'à 120 requêtes par minute. Les requêtes de consultation et de création de tâches sont comptabilisées séparément.

Les requêtes de création d'images et de vidéos partagent la même limite de débit liée à la clé API.

L'erreur HTTP 429 renvoie l'en-tête Retry-After: 60 pour la création et Retry-After: 5 pour les requêtes d'interrogation. Utilisez une stratégie d'attente progressive (backoff) et évitez d'interroger l'API plus souvent que nécessaire.

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}