Seedance 2.0 API
Referência completa da API dos modelos de geração de vídeo Seedance 2.0 da ByteDance.
Variantes de modelos
Esta API oferece seis variantes:
Comparação rápida
Proporções de tela compatíveis
21:9, 16:9, 9:16, 1:1, 4:3, 3:4
Opções de resolução
Seedance 2.0 Texto para vídeo
Ponto de extremidade
POST /api/v1/video/task
Parâmetros da requisição
Obrigatórios
Opcionais
Exemplo de requisição
javascript
Seedance 2.0 Imagem para vídeo
Parâmetros da requisição
Obrigatórios
Opcionais
Exemplo de requisição
javascript
Seedance 2.0 Referências para vídeo
Parâmetros da requisição
Obrigatórios
Mídias de referência
Envie 1-9 imagens. As imagens só podem ser omitidas quando pelo menos um vídeo de referência for fornecido.
Marcadores de referência @ (AT)
O recurso @ (AT) vincula as mídias de referência ao prompt por marcadores numerados <<<...>>>. A numeração começa em 1 de forma independente para cada tipo de mídia e segue a ordem do array correspondente:
Por exemplo, se a primeira imagem é uma referência de personagem e a segunda de cenário, use <<<image_1>>> para o personagem e <<<image_2>>> para o cenário em prompt. Cada marcador deve apontar para um item existente no array correspondente.
Opcionais
Exemplo de requisição
javascript
Exemplo de requisição Referências para vídeo com @ (AT)
javascript
Variantes Fast
As variantes Fast priorizam a velocidade de processamento. Todos os modelos Fast aceitam saída apenas em "480p" e "720p". Fast Texto para vídeo e Fast Imagem para vídeo seguem, nos demais aspectos, as estruturas de requisição dos modelos padrão correspondentes, enquanto Fast Referências para vídeo usa os mesmos limites de mídia de referência do modelo padrão.
Exemplo de requisição Fast
javascript
Exemplo de requisição Fast Referências para vídeo com @ (AT)
javascript
Parâmetros de Seedance 2.0 Fast Referências para vídeo
Obrigatórios
Mídias de referência
A mesma convenção de marcadores iniciados em 1 se aplica ao modelo Fast Referências para vídeo.
Opcionais
Limites de mídia
Estes limites se aplicam às imagens dos quadros inicial e final e às mídias de referência dos modelos desta página.
Áudios e vídeos de referência têm, cada um, um limite independente de duração total de 15 segundos. As quantidades são independentes: até 9 imagens, 3 vídeos e 3 clipes de áudio. Adicionar vídeos não reduz a quantidade permitida de imagens.
Todos os modelos usam 720p por padrão, mas resolution continua obrigatório. O controle de som tem valor padrão true; nem esse controle nem o áudio de referência alteram o preço. Referências para vídeo exige pelo menos uma imagem ou um vídeo; requisições apenas com áudio não são aceitas. Enviar vídeos de referência dobra a cobrança da geração, independentemente da quantidade ou duração.
Formato da resposta
Resposta inicial
Todos os modelos retornam um task_id para consulta periódica:
json
Resposta da consulta
Consulte GET /api/v1/video/{taskId} para verificar o status:
json
Valores de status
submitted: tarefa aceita e aguardando processamentoprocessing: geração de vídeo em andamentosucceed: geração de vídeo concluídafailed: falha na geração de vídeo
Tempo de processamento
Modelos padrão: 3-8 minutos, conforme a duração e a resolução.
Modelos Fast: 1-4 minutos para a maioria das configurações.
Consulte o status a cada 5-10 segundos.
Boas práticas
- Escolha a variante adequada: use modelos Fast para iterações e modelos padrão para a saída final
- Descreva claramente o movimento: inclua descrições específicas de movimento nos prompts
- Seleção da resolução: todos os modelos padrão Seedance 2.0 aceitam
480p,720p,1080pe4k; todos os Fast aceitam apenas480pe720p - Ordem das referências: mantenha
images,videoseaudiosem uma ordem intencional e faça referências consistentes no prompt - Requisições apenas com vídeo: use um array
imagesvazio somente quando pelo menos um vídeo de referência for fornecido - Duração da mídia: mantenha cada áudio e vídeo de referência entre 2 e 15 segundos
- Uso do áudio: omita
soundpara usar o padrãotrue, ou defina comofalsepara desativar o som gerado