Erreurs

Codes d’erreur du Video MCP : ce qu’ils signifient et ce que l’agent doit faire ensuite.

Les échecs de tâche apparaissent dans get_status avec l’état failed, et non comme des erreurs du protocole MCP. Il est normal que create_video réussisse et renvoie un jobId.

CodeSignification
UNAUTHORIZEDAuthentification OAuth manquante ou invalide
PLAN_REQUIREDUn plan Gratuit a appelé le Video MCP
FORBIDDENVous n’êtes pas membre de l’espace de travail
NOT_FOUNDProjet, tâche ou élément introuvable
CREDITS_EXHAUSTEDLe propriétaire ne peut pas payer cette tâche
RECIPE_REQUIRES_FOOTAGEedit sans élément vidéo
RECIPE_REQUIRES_BRIEFBrief vide
ASSET_NOT_READYL’importation est encore en cours de traitement : relancez create_video
JOB_STILL_RUNNINGUne autre tâche est active sur le projet
GENERATION_FAILEDLa génération de clip ou d’image a échoué après plusieurs tentatives
COMPOSE_FAILEDLa création ou la validation a échoué
EXPORT_FAILEDLe rendu a échoué
RATE_LIMITEDPatientez avant de réessayer ; Retry-After peut être présent

Ce que l’agent doit faire

  • UNAUTHORIZED : terminez l’authentification OAuth dans le navigateur, puis réessayez. Consultez OAuth et accès.
  • PLAN_REQUIRED ou CREDITS_EXHAUSTED : arrêtez-vous et affichez l’URL de facturation. Ne réessayez pas.
  • JOB_STILL_RUNNING : interrogez get_status ou utilisez cancel_job.
  • ASSET_NOT_READY : patientez et relancez create_video.
  • RECIPE_REQUIRES_FOOTAGE : importez un élément vidéo, ou passez à generate / compose.
  • Échecs de composition récupérables : utilisez revise_video avec le message d’erreur.

Les problèmes de connexion (le serveur n’apparaît jamais, boucle OAuth) sont traités sur la page de chaque agent et dans Dépannage.