Erros
Códigos de erro do Video MCP — o que significam e o que o agente deve fazer em seguida.
As falhas de job aparecem em get_status como failed, e não como erros de protocolo do MCP. É esperado que create_video funcione e retorne um jobId.
| Código | Significado |
|---|---|
UNAUTHORIZED | OAuth ausente ou inválido |
PLAN_REQUIRED | Um plano Grátis tentou usar o Video MCP |
FORBIDDEN | Não é membro do espaço de trabalho |
NOT_FOUND | Projeto, job ou ativo inexistente |
CREDITS_EXHAUSTED | O proprietário não tem créditos para este job |
RECIPE_REQUIRES_FOOTAGE | edit sem um ativo de vídeo |
RECIPE_REQUIRES_BRIEF | Briefing vazio |
ASSET_NOT_READY | Envio ainda em processamento — tente create_video de novo |
JOB_STILL_RUNNING | Outro job está ativo no projeto |
GENERATION_FAILED | A geração do clipe/imagem falhou após novas tentativas |
COMPOSE_FAILED | Falha na criação ou na validação |
EXPORT_FAILED | Falha na renderização |
RATE_LIMITED | Aguarde antes de tentar de novo; Retry-After pode estar presente |
O que o agente deve fazer
UNAUTHORIZED— conclua o OAuth no navegador e tente de novo. Veja OAuth e acesso.PLAN_REQUIREDouCREDITS_EXHAUSTED— pare e mostre a URL de cobrança. Não tente de novo.JOB_STILL_RUNNING— consulteget_statusou usecancel_job.ASSET_NOT_READY— espere e tentecreate_videode novo.RECIPE_REQUIRES_FOOTAGE— envie um ativo de vídeo ou mude paragenerate/compose.- Falhas de composição recuperáveis — use
revise_videocom a mensagem de erro.
Problemas de conexão (o servidor nunca aparece, loop de OAuth) são tratados na página de cada agente e em Solução de problemas.