Erros e diagnóstico

Erros da camada pública incluem código legível por máquina e um requestId, também disponível no header X-Request-Id:

{"error":{"code":"INSUFFICIENT_SCOPE","message":"This credential does not permit this operation.","requestId":"ID_DO_PEDIDO_HTTP"}}

HTTP / código	Próximo passo
401 INVALID_CREDENTIAL	Confira chave/token, validade e revogação; reconecte o cliente OAuth se necessário
403 AUTOMATION_REQUIRED	Confira plano base e API + MCP em Assinatura/Integrações
403 INSUFFICIENT_SCOPE	Use uma credencial com a permissão exata; não conceda acesso amplo desnecessário
404 NOT_FOUND	Confira o ID e a conta; recursos de outra conta não são revelados
409 IDEMPOTENCY_CONFLICT	A chave já identifica outro payload; recupere a intenção original
409 em cancelamento/exclusão	O trabalho já iniciou ou há referências em uso; não force a operação
410	Conteúdo ou pedido visível expirou; não é um comando para repetir automaticamente
413 BODY_TOO_LARGE / REFERENCE_TOO_LARGE	Reduza body/imagem conforme o limite
415 INVALID_CONTENT_TYPE	Envie JSON nas rotas JSON
422 INVALID_PARAMETER / BATCH_LIMIT	Corrija o payload ou consulte capacidades do plano
429 DAILY_VIDEO_LIMIT	Aguarde o resetsAt informado; não crie outra conta/chave para contornar
429 REQUEST_RATE_LIMIT	Respeite Retry-After e reduza polling
429 de fila/pacing	Aguarde capacidade; não substitua a identidade de uma criação já enviada
503	Serviço em manutenção/indisponível; mantenha IDs e retry seguro

Assistente não conecta

Confira URL /mcp, suporte a Streamable HTTP, OAuth/PKCE e assinatura com automação. Inicie uma conexão nova se o consentimento expirou. Revogar e autorizar novamente pode resolver uma conexão antiga; isso não exige repetir gerações anteriores.

Se o cliente enviar Origin, ele precisa ser permitido. Um erro de Origin não deve ser contornado removendo controles de segurança do navegador.

Pagamento confirmado, automação ainda inativa

Consulte Assinatura e use atualização de status. O retorno de checkout não é confirmação por si só; o acesso depende de notificação verificada. Não compre o adicional novamente enquanto a primeira compra está em confirmação.

Ao falar com suporte, informe requestId, ID da geração e horário aproximado. Nunca envie chave, token, cookie, dados do cartão ou URL privada de download.