Erreurs

Le Reigniter API utilise des codes d’état HTTP standard. Chaque réponse à l’erreur est JSON.

Corps d’erreur

La plupart des erreurs ressemblent à ceci :

{
  "error": "Rate limit exceeded",
  "code": "RATE_LIMITED",
  "retryAfter": 37
}

Terrain	Toujours présent	Ce que c’est
`error`	Oui	Un message que vous pouvez montrer à une personne. Cela peut changer de formulation, donc ne correspondez pas dessus.
`code`	Le plus grand nombre d’erreurs	Un code majuscule stable. Branche sur ce sujet.
`details`	Quelques erreurs	Contexte supplémentaire, par exemple `retryAfter` ou des chiffres d’utilisation.
`retryAfter`	Quelques `429`s	Quelques secondes avant de réessayer.

Quelques erreurs n’ont pas de code, comme 404 Job not found et 403 Forbidden. Branchez sur le statut pour celles-ci.

Erreurs de validation

Lorsque le corps de la requête ne correspond pas au schéma, vous obtenez 400 avec une chaîne de detail qui liste chaque problème comme field: message:

{
  "error": "Validation failed",
  "detail": "aspect: Invalid option: expected one of \"9:16\"|\"16:9\"|\"1:1\"|\"4:5\"|\"4:3\"|\"3:4\""
}

Codes de statut

Statut	Signification	Que faire
`200`	Succès.
`201`	Créés (webhooks).
`202`	Accepté. Le rendu a commencé.	Interrogez le poste ou attendez le webhook.
`400`	La demande a été refusée. Rien n’a été retenu.	Corrigez la requête. Ne réessayez pas sans changer.
`401`	Clé manquante, invalide ou révoquée API.	Vérifie la clé.
`402`	Problème de planification, de crédit ou d’utilisation.	Lisez `code`.
`403`	Compte suspendu, ou un emploi qui ne t’appartient pas.	Contactez le support ou vérifiez l’identifiant du poste.
`404`	Pas trouvé.	Vérifiez l’ID ou le chemin.
`409`	Demande en double ou limite atteinte.	Lisez `code`.
`413`	Ce rendu coûterait plus cher que la limite par rendu.	Utilisez moins de scènes ou un `quality` plus bas.
`422`	Le rendu n’a ni marque, ni produit, ni présentateur pour l’ancrer.	Voir les vidéos de création.
`429`	Trop de requêtes ou trop de rendus en même temps.	Attends et réessaie. Voir les limites.
`500`	Quelque chose a mal tourné de notre côté.	Réessayez plus tard.
`502`	La planification de ton mémoire a échoué. Les crédits d’urbanisme ont été remboursés.	Réessayez, ou reformulez le cahier des charges.
`503`	Le rendu est mis en pause ou un service est en panne. Rien n’a été facturé.	Réessayez plus tard.

Un chemin inconnu sous /v1/ revient 404 avec code: "NOT_FOUND".

Codes d’erreur

Authentification et plan

Code	Statut	Signification
`NO_API_KEY`	401	Pas d’en-tête `Authorization`, ou le jeton ne commence pas par `emp_`.
`INVALID_API_KEY`	401	La clé est inconnue ou révoquée.
`PLAN_UPGRADE_REQUIRED`	402	API accès nécessite le plan Agency.
`ACCOUNT_SUSPENDED`	403	Le compte est suspendu.

Crédits et utilisation

Code	Statut	Signification
`NO_CREDITS`	402	Le compte n’a plus de crédits.
`INSUFFICIENT_CREDITS`	402	Pas assez de crédits pour ce rendu.
`ABUSE_CAP_EXCEEDED`	402	La limite mensuelle d’utilisation du forfait est atteinte.
`STORAGE_FULL`	402	La vidéothèque du compte est pleine. Supprimez certaines vidéos.
`UPGRADE_REQUIRED`	402	La vidéo a besoin d’un forfait payant.
`REQUEST_COST_TOO_HIGH`	413	Ce rendu coûterait plus cher que la limite par rendu.

Voir Compte et facturation pour les crédits et plans.

Requêtes de rendu

Code	Statut	Signification
`CONTENT_BLOCKED`	400	Le brief ou une scène enfreint les règles de contenu.
`PRODUCT_IMAGE_REQUIRED`	400	Ce format nécessite `product_image_url`, ou `product_enabled: false`.
`PRESENTER_REQUIRED`	400	Une scène de parole n’a pas de visage. Ajoute `avatar_preset_id`, ou envoie `presenter_enabled: false`.
`UNSUPPORTED_MODEL`	400	Une scène a demandé un modèle de rendu Reigniter ne peut pas utiliser.
`BRAND_REQUIRED`	422	Une marque a été demandée mais aucune n’a été trouvée. Envoyez- `brand_logo_url`.
`NO_ANCHOR`	422	Pas de marque, de photo de produit ou de présentateur. Ajoutez-en une, ou désinscrivez-vous.
`CANVAS_NOT_FOUND`	404	Un projet référencé n’est pas inscrit sur ce compte.
`DUPLICATE_REQUEST`	409	Ce `Idempotency-Key` était déjà utilisé. Rien de nouveau n’a été chargé.
`PLAN_FAILED`	502	La planification du mémoire a échoué. Les crédits d’urbanisme ont été remboursés.

Avec un brief, un Idempotency-Key répété peut aussi revenir comme 402 avec le message This request was already submitted. Traitez-le comme un doublon, pas comme un problème de crédit.

Taux et concurrence

Code	Statut	Signification
`RATE_LIMITED`	429	Trop de demandes. Attends `retryAfter` (ou `details.retryAfter`) secondes.
`CONCURRENT_LIMIT`	429	Trop de rendus en cours en même temps. Attends qu’un soit fini.

Service

Code	Statut	Signification
`USAGE_CHECK_UNAVAILABLE`	503	L’utilisation n’a pas pu être vérifiée, donc le rendu est mis en pause. Rien n’a été facturé.
`DB_UNAVAILABLE`	503	Un service est brièvement indisponible.
`FEATURE_NOT_AVAILABLE`	503	Le rendu n’est pas disponible pour le moment.
`GLOBAL_KILL_SWITCH`	503	Le rendu est mis en pause pour tout le monde.
`FEATURE_KILL_SWITCH`	503	Cette fonctionnalité est mise en pause.
`USER_KILL_SWITCH`	503	Ce compte est temporairement restreint. Contactez le support.

Webhooks

Code	Statut	Signification
`UNKNOWN_EVENT`	400	Ce n’est pas un événement auquel tu peux t’abonner. La réponse liste les événements valides.
`URL_NOT_DELIVERABLE`	400	L’URL n’est pas une adresse http publique.
`HOOK_LIMIT`	409	Le compte possède déjà le nombre maximal de webhooks.

Réessayer en toute sécurité

Réessayez 429, 500, 502 et 503 avec le backoff. Ne réessayez pas d’autres 4xx inchangés.
Envoyez toujours un Idempotency-Key sur POST /v1/render.
Aucune réponse (délai d’attente ou coupure de connexion) : réessayez avec la même clé. Si la première requête a lancé un rendu, la réessayage est refusée au lieu d’en lancer une seconde.
Une réponse d’erreur : aucun rendu n’a été lancé pour cette requête. Corrigez la cause, puis réessayez avec une nouvelle clé, car une requête qui a échoué en partie a peut-être déjà utilisé sa clé. Les crédits de rendu sont remboursés. Le seul frais qui n’est pas remboursé est la planification brève, lorsque le rendu prévu est alors refusé ( voir Création de vidéos).
Si un rendu a été accepté (202) et échoue par la suite, le status du travail devient failed et error explique pourquoi. Les crédits pour un travail qui n’a pas eu lieu sont remboursés.