Errores
Códigos de error de Vídeo MCP — qué significan y qué debe hacer el agente a continuación.
Los fallos en las tareas aparecen en get_status como failed, no como errores del protocolo MCP. Que create_video tenga éxito con una jobId es lo esperado.
| Código | Significado |
|---|---|
UNAUTHORIZED | OAuth faltante o inválido |
PLAN_REQUIRED | El plan gratuito ha alcanzado el límite de Vídeo MCP |
FORBIDDEN | No eres miembro del espacio de trabajo |
NOT_FOUND | Faltan proyecto, trabajo o activo |
CREDITS_EXHAUSTED | El propietario no puede pagar este trabajo |
RECIPE_REQUIRES_FOOTAGE | edit without a vídeo asset |
RECIPE_REQUIRES_BRIEF | Breve vacío |
ASSET_NOT_READY | La subida sigue procesándose — vuelve a intentarlo con create_video |
JOB_STILL_RUNNING | Hay otra tarea activa en el proyecto |
GENERATION_FAILED | Falló la creación de la imagen/vídeo tras varios intentos |
COMPOSE_FAILED | Falló la creación o validación |
EXPORT_FAILED | Falló el renderizado |
RATE_LIMITED | Espera un momento; puede estar presente Retry-After |
Qué debe hacer el agente
UNAUTHORIZED— completa la autenticación OAuth del navegador, luego vuelve a intentarlo. Consulta OAuth y acceso.PLAN_REQUIREDoCREDITS_EXHAUSTED— detente y muestra la URL de facturación. No vuelvas a intentarlo.JOB_STILL_RUNNING— consultaget_statusocancel_job.ASSET_NOT_READY— espera y vuelve a intentarcreate_video.RECIPE_REQUIRES_FOOTAGE— sube un activo de vídeo, o cambia agenerate/compose.- Recuperar fallos de composición —
revise_videocon el mensaje de error.
Los problemas de conexión (el servidor nunca aparece, bucle OAuth) están cubiertos en cada página de agente y en Solución de problemas.