Erros e solução de problemas

Diagnostique falhas de conexão, entrada e recuperação antes de repetir.

Leia a resposta de erro

Falhas de ferramentas HTTP normalmente retornam error com code, message e traceId; erros de validação podem incluir details. Confira também o status HTTP. Proxies e limites de tamanho podem retornar outro formato; clientes de produção devem tratar respostas não JSON. Registre ferramenta, horário, ID do job e traceId para diagnóstico, removendo credenciais e URLs privadas de mídia.

json

{
  "error": {
    "code": "INVALID_JSON",
    "message": "Malformed JSON",
    "traceId": "<diagnostic-id>"
  }
}

Falhas comuns

Sinal	Solução
401 · UNAUTHORIZED	Confira a chave do espaço de trabalho e o cabeçalho Bearer, não o login do site ou a chave do provedor.
403 · FORBIDDEN	Confira escopo read/write/admin, propriedade e regras de origem do navegador.
404 · NOT_FOUND	Confira nome da ferramenta, versão instalada e conta proprietária do registro.
400 · INVALID_JSON	Envie JSON válido com o tipo de conteúdo correto.
UPLOAD_EXPIRED / UPLOAD_MISMATCH	Crie uma nova intenção se expirou; caso contrário, confira bytes e SHA-256 do arquivo exato.
REVISION_CONFLICT	Leia o snapshot atual e reaplique a edição sem sobrescrever trabalho mais recente.
413	Reduza o corpo. Use a rota de upload binário para materiais, não um argumento base64.

Regras de repetição

Repita leituras com atraso limitado em falhas temporárias de rede. Para uma mutação com resposta incerta, recupere primeiro o job ou pedido salvo. Reutilize a chave de idempotência apenas para a mesma operação e conteúdo. Alterar briefing, modelo ou referência exige nova preparação. Uma conexão interrompida não significa cancelamento do trabalho no provedor.

Quando um modelo está indisponível

Leia capabilities novamente e confira disponibilidade, modo de entrada e requisitos ausentes. Um perfil no catálogo não comprova que chave, saldo ou referências estejam prontos. Mantenha a seleção explícita; não troque de provedor, remova referências ou mude para texto-para-vídeo sem informar. Se faltar um recurso no pacote instalado, consulte o guia dessa versão ou atualize pelo procedimento suportado.

Referência do rikoko 0.1.30, revisada em 21 de outubro de 2026. O instalador público segue uma versão própria; consulte os parâmetros e modelos na instalação que você usa.