Nesta página
- Resposta curta
- Depure uma requisição do Seedance que falhou
- Erros de requisição (a chamada HTTP falha)
- Erros de job (o job termina como falho, tokens liberados)
- Por que minha referência foi rejeitada?
- Por que o vídeo saiu com outra proporção?
- Por que camera_fixed falhou com uma imagem de entrada?
- Perguntas frequentes
Resposta curta
Existem dois tipos de erro. Erros de requisição fazem a própria chamada HTTP falhar (parâmetros errados, chave inválida, saldo baixo, limite de taxa) e nada é reservado. Erros de job encerram um job já aceito como falho, com um errorCode no job, e os tokens reservados são liberados. As tabelas abaixo listam cada código com a correção.
Comece agora
Depure uma requisição do Seedance que falhou
- 1
Leia o código, não a mensagem
Trate pelo code (erros de requisição) ou pelo job.errorCode (erros de job); as mensagens podem mudar, os códigos não.
- 2
Confira os limites primeiro
A maioria dos 400 é uma duração, resolução ou proporção que o modelo não oferece. GET /v1/models lista os limites de cada modelo.
- 3
Respeite os 429
Aguarde os segundos indicados em Retry-After antes de enviar de novo.
- 4
Reenvie com segurança
Depois de um timeout, reenvie com a mesma Idempotency-Key. Depois de um prompt recusado, mude o prompt e use uma chave nova.
Erros de requisição (a chamada HTTP falha)
| Código | Status | Significado | Correção |
|---|---|---|---|
| invalid_api_key | 401 | A chave está ausente, incorreta ou foi revogada. | Envie Authorization: Bearer <key>. Crie uma nova chave se ela foi revogada. |
| insufficient_balance | 402 | Não há tokens suficientes para o custo cotado. | Recarregue em Billing. data.top_up_url leva até lá. |
| account_not_active | 403 | A conta de desenvolvedor está suspensa. | Fale com o suporte. |
| scope_missing | 403 | A chave não tem o escopo que este endpoint exige. | Use uma chave com esse escopo. |
| job_not_found | 404 | Não existe job com esse id na conta desta chave. | Confira o id; os jobs são privados de cada conta. |
| character_not_found | 404 | O id ou slug do personagem não existe. | Liste os personagens com GET /v1/characters. |
| upload_not_found | 404 | O upload_id não existe neste workspace. | Crie o upload novamente. |
| reference_upload_not_found | 404 | Um upload_id de referência não existe neste workspace. | Envie o arquivo de novo e use o novo upload_id. |
| video_edit_source_not_found | 404 | O source_video_upload_id não existe. | Envie o clipe com upload_type VIDEO. |
| upload_in_use | 409 | Um job na fila ou em processamento ainda usa este upload. | Apague o upload depois que o job terminar. |
| character_pending | 409 | O personagem ainda está em análise. Nada foi reservado. | Aguarde retry_after segundos e envie de novo. |
| upload_too_large | 413 | O arquivo passa do limite de tamanho do seu tipo. | Imagens 50 MB, vídeo 200 MB, áudio 15 MB. |
| character_registration_failed | 422 | A imagem do personagem não passou na análise. | Cadastre o personagem de novo com outra imagem. |
| rate_limited | 429 | Requisições demais dentro da janela. | Aguarde os segundos indicados no cabeçalho Retry-After. |
| prompt_required | 400 | Nenhum prompt (ou texto, no caso de fala) foi enviado. | Adicione um prompt. |
| prompt_too_long | 400 | O prompt passa do limite do modelo. | Encurte o prompt; GET /v1/models mostra maxPromptChars. |
| model_not_found | 400 | Alias de modelo desconhecido. | Use um id de GET /v1/models. |
| duration_not_supported | 400 | O modelo não oferece essa duração. | Envie uma das durações do modelo. |
| aspect_ratio_not_supported | 400 | O modelo não oferece essa proporção. | Envie uma das proporções do modelo. |
| resolution_not_supported | 400 | O modelo não oferece essa resolução. | Envie uma das resoluções do modelo. |
| reference_combination_not_supported | 400 | Essas referências não podem ser combinadas, por exemplo quadros inicial/final com imagens de referência. | Envie um único tipo por requisição. |
| character_prompt_unsafe | 400 | O prompt de um personagem pede para imitar uma pessoa real. | Descreva aparência, roupas, pose e estilo. |
| person_match_prompt_unsafe | 400 | O prompt de uma referência pede para imitar o rosto ou a aparência de uma pessoa real. | Cadastre um personagem próprio e descreva o visual. |
| upload_invalid | 400 | A requisição de upload não tem um campo ou tem um tipo inválido. | Envie file_name, mime_type, file_size e upload_type. |
| video_edit_model_not_supported | 400 | Edições de vídeo exigem um modelo da família Seedance 2.0 (2.0, Fast ou Mini). | Use kreator-video-pro, kreator-video-fast ou kreator-video-mini. |
| video_edit_source_required | 400 | Uma edição de vídeo precisa de um clipe de origem. | Envie source_video_upload_id ou video. |
| voice_required | 400 | A fala precisa de uma voz. | Use um id de GET /v1/voices. |
| internal_error | 500 | Algo falhou do nosso lado. | Reenvie com a mesma Idempotency-Key. |
| dispatch_disabled | 503 | A geração está pausada neste ambiente. | Tente de novo mais tarde. |
Erros de job (o job termina como falho, tokens liberados)
| Código | Significado | Correção |
|---|---|---|
| reference_rejected | Uma referência foi recusada (muitas vezes a foto de uma pessoa real). | Cadastre o rosto como personagem ou use outra imagem. |
| reference_asset_pending | Uma referência nova ainda está em análise. | Aguarde errorData.retry_after segundos e reenvie com o mesmo upload_id e uma nova Idempotency-Key. |
| reference_asset_failed | A referência não passou na análise. | Use outro arquivo. |
| generation_rejected | A requisição foi recusada (prompt, referência ou opções). | Mude o prompt, a referência ou as opções e tente de novo. |
| generation_timeout | O job não terminou a tempo. Os tokens reservados são liberados. | Tente de novo com uma nova Idempotency-Key. |
| generation_unavailable | O modelo está temporariamente indisponível. | Tente mais tarde ou escolha outro modelo. |
| generation_failed | A geração falhou. | Tente de novo; mude o prompt ou as referências se a falha se repetir. |
Por que minha referência foi rejeitada?
Referências e prompts que pedem para imitar uma pessoa real, uma celebridade ou uma figura pública são recusados. Isso inclui fotos de pessoas reais usadas como referência e prompts que citam alguém para imitar. Descreva aparência, roupas e estilo, ou cadastre um personagem seu com POST /v1/characters e envie o id dele.
Por que o vídeo saiu com outra proporção?
Com uma imagem ou primeiro quadro de entrada, adaptive segue a imagem. Envie um aspect_ratio explícito quando o resultado precisar seguir um formato, e confira se o modelo oferece essa proporção.
Por que camera_fixed falhou com uma imagem de entrada?
Não envie camera_fixed quando mandar uma imagem ou quadro de entrada; descreva a câmera no prompt (por exemplo locked-off camera).
Perguntas frequentes
Sou cobrado quando um job do Seedance falha?
Não. Os tokens reservados de um job com falha são liberados.
O que significa insufficient_balance?
Seu saldo de tokens é menor que a cotação do job. Recarregue no console; nada foi reservado.
O que fazer quando recebo um 429?
Aguarde o número de segundos indicado no cabeçalho Retry-After e envie de novo.
Por que meu prompt foi recusado?
Ele pedia para imitar uma pessoa real ou violava a política de uso aceitável. Mude o prompt e crie um novo job.
