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 comcgt-; 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.Regras de conteúdo
- Use
type=textpara o texto do prompt. type=image_urlsemroleé tratado como o primeiro frame; você também pode definirrole=first_frame.- Use
role=last_framesomente junto com um primeiro frame. - Use
role=reference_image,reference_videooureference_audiopara 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
ratioaceita16:9,4:3,1:1,3:4,9:16,21:9ouadaptive.- O padrão oficial de
generate_audioéfalse; definatruequando precisar de áudio sincronizado. service_tier=defaulté aceito. Tarefas compatíveis Seedance 2.0 rejeitamservice_tier=flex,framesecamera_fixed=true.- Quando o modelo selecionado suportar,
toolspode incluir objetos como{ "type": "web_search" }. Entradas tool malformadas são rejeitadas em vez de ignoradas.