Skip to main content

Visão geral

Estes endpoints são para equipes que já usam o formato de tarefa Seedance no estilo Volc. A autenticação usa sua API key Bearer da TokenLab. O ID retornado começa com cgt-; consulte o status até que status seja succeeded, failed, cancelled ou expired. O contrato oficial de tarefas usa os caminhos REST em /api/v3/contents/generations/tasks. Os aliases Action antigos permanecem apenas para integrações TokenLab existentes e não fazem parte do contrato oficial compatível no protocolo. callback_url aceita um endereço HTTP(S) público. A TokenLab envia exatamente o objeto de consulta em cada mudança para queued, running, succeeded, failed ou expired, sem headers privados da TokenLab. succeeded e failed são repetidos até três vezes após cinco segundos.
Para recuperar com segurança após uma desconexão, envie um Idempotency-Key único na criação REST. Repetir o mesmo body com a mesma chave retorna o mesmo ID cgt-...; a mesma chave com outro body retorna 409. Isso não se aplica à rota Action antiga.
Veja também Modelos de vídeo Seedance 2.0 e Geração de vídeo.

Regras de conteúdo

  • Use type=text para o texto do prompt.
  • type=image_url sem role é tratado como o primeiro frame; você também pode definir role=first_frame.
  • Use role=last_frame somente junto com um primeiro frame.
  • Use role=reference_image, reference_video ou reference_audio para mídia de referência.
  • Não misture entradas de primeiro/último frame com mídia de referência na mesma solicitação.

Notas de parâmetros

  • ratio aceita 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 ou adaptive.
  • O padrão oficial de generate_audio é false; defina true quando precisar de áudio sincronizado.
  • service_tier=default é aceito. Tarefas compatíveis Seedance 2.0 rejeitam service_tier=flex, frames e camera_fixed=true.
  • Quando o modelo selecionado suportar, tools pode incluir objetos como { "type": "web_search" }. Entradas tool malformadas são rejeitadas em vez de ignoradas.

Exemplo