seedance-2-0
seedance-2.0 — Geração de vídeo
- Modo de processamento assíncrono, retorna um ID de tarefa para consultas posteriores
- Suporta texto-para-vídeo e imagem-para-vídeo (primeiro frame/último frame)
- Suporta vídeo de referência, áudio de referência e vídeo com áudio
- Suporta proporções paisagem, retrato, quadrada, ultrawide e adaptativa
POST
Autenticação
string
obrigatório
Todos os endpoints da API exigem autenticação via Bearer TokenObtenha sua API Key:Acesse a página de gerenciamento de API Keys para obter sua API KeyAdicione-a ao cabeçalho da requisição:
Parâmetros da requisição
string
obrigatório
Nome do modelo de geração de vídeoModelos suportados:
seedance-2.0— versão padrão, suporta texto-para-vídeo, imagem-para-vídeo, vídeo com primeiro/último frame, vídeo de referência, áudio de referência e vídeo com áudioseedance-2.0-fast— versão rápida, com os mesmos recursos da versão padrão e maior velocidade de geraçãoseedance-2.0-mini— versão mini, com os mesmos recursos da versão padrão
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de vídeo.Resposta quando detectado:
true: verificar prompts e imagens de entrada comomni-moderation-latestfalseou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
- Texto:
prompt,negative_prompt - Imagens:
image_urls,image_with_roles[].url,first_frame_image,last_frame_image - Assets privados de imagem
asset://: resolver e verificar a URL pública original - Imagens Base64: verificar após a conversão para uma URL pública
video_urls, audio_urls e assets privados de vídeo/áudio não são verificados, pois o modelo de moderação não aceita vídeo nem áudio.IDs de modelo compatíveis: seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-2.0-face, seedance-2.0-fast-face, seedance-2-0 (nome antigo) e seedance-2.5.A chamada de moderação não é cobrada do usuário que envia a solicitação de vídeo.Exemplo:string
Descrição do conteúdo do vídeoObrigatório para texto-para-vídeo; opcional para imagem-para-vídeo ou vídeo a partir de vídeo de referênciaRecomenda-se especificar claramente o sujeito, a ação, o movimento de câmera e o estilo para obter melhores resultados de geraçãoExemplo:
"A kitten yawning at the camera"integer
padrão:"5"
Duração do vídeo (segundos)Faixa suportada:
4 a 15 segundosPadrão: 5string
padrão:"16:9"
Proporção do vídeoA proporção deve estar entre 0.5 e 2.5Opções:
16:9— paisagem9:16— retrato1:1— quadrado4:3— proporção tradicional3:4— proporção tradicional vertical21:9— ultrawideadaptive— adaptativa (corresponde automaticamente à imagem/vídeo de entrada)
16:9string
padrão:"720p"
Resolução do vídeoOpções:
480p— definição padrão720p— alta definição1080p— Full HD (suportado apenas porseedance-2.0)4k— Ultra HD (suportado apenas porseedance-2.0)
720pinteger
Seed aleatória para controlar a aleatoriedade do conteúdo gerado
- Para a mesma requisição, valores de seed diferentes produzirão resultados diferentes
- Para a mesma requisição, o mesmo valor de seed produzirá resultados semelhantes, mas não há garantia de consistência exata
boolean
padrão:"true"
Se deve gerar áudio (vídeo com áudio)Quando definido como
true, o vídeo incluirá áudio gerado por IA acompanhando-oQuando definido como false, o vídeo não incluirá áudio (vídeo sem som)Padrão: trueboolean
padrão:"false"
Se deve retornar a imagem do último frameQuando definido como
true, o resultado da tarefa retornará adicionalmente a URL da imagem do último frame do vídeo, que pode ser usada para geração contínua de vídeoPadrão: falsearray<object>
Lista de ferramentas para recursos adicionais, como busca na webExemplo:
[{"type": "web_search"}]array<string>
Array de URLs de imagem para imagem-para-vídeoSuporta dois formatos:
- URL de imagem comum:
https://example.com/cat.jpg - Asset URL (asset aprovado):
asset://asset_a
["https://example.com/cat.jpg"] ou ["asset://asset_a"]Asset URLs são compatíveis com todos os modelos Seedance 2.0:
seedance-2.0, seedance-2.0-fast e seedance-2.0-mini.array
Array de imagens com papéis, permite especificar primeiro frame/último frameExemplo:Formato Asset URL:
Quando o campo
url usa uma Asset URL, todos os modelos Seedance 2.0 são compatíveis: seedance-2.0, seedance-2.0-fast e seedance-2.0-mini.array<string>
Array de URLs de vídeo de referênciaSuporta dois formatos:
- URL de vídeo comum:
https://example.com/reference.mp4 - Asset URL (asset aprovado):
asset://asset_a
["https://example.com/reference.mp4"] ou ["asset://asset_a"]Asset URLs são compatíveis com todos os modelos Seedance 2.0:
seedance-2.0, seedance-2.0-fast e seedance-2.0-mini.array<string>
Array de URLs de áudio de referênciaSuporta dois formatos:
- URL de áudio comum:
https://example.com/speech.wav - Asset URL (asset aprovado):
asset://asset_a
["https://example.com/speech.wav"] ou ["asset://asset_a"]Asset URLs são compatíveis com todos os modelos Seedance 2.0:
seedance-2.0, seedance-2.0-fast e seedance-2.0-mini.Resposta
integer
Código de status da resposta, 200 em caso de sucesso
array
Array de dados da resposta
Casos de uso
Caso 1: Texto-para-vídeo
Caso 2: Imagem-para-vídeo (primeiro frame)
Caso 3: Vídeo com primeiro/último frame
Caso 4: Vídeo a partir de vídeo de referência
Caso 5: Vídeo de referência + áudio de referência
Caso 6: Vídeo com áudio
Caso 7: Geração contínua de vídeo (retornar último frame)
Caso 8: Geração com a versão rápida
Caso 9: Imagens de referência + vídeo de referência + áudio de referência (vídeo multimodal)
Combine imagens de referência, vídeo de referência e áudio de referência para gerar um vídeo publicitário imersivo em perspectiva em primeira pessoa. Ideal para divulgação de produtos, anúncios de marca e outros cenários que exigem a fusão de múltiplas fontes de material.Caso 10: Imagem-para-vídeo com Asset URL
Assets de avatar virtual aprovados podem ser passados diretamente como imagens de referência, sem necessidade de novo upload ou nova revisão.Caso 11: Especificar retrato de referência com Asset URL (image_with_roles)
Caso 12: Versão rápida + Asset URL imagem-para-vídeo
Caso 13: Imagem com Asset URL + vídeo de referência (transferência de movimento)
Combine um asset de retrato aprovado com um vídeo de referência para fazer o personagem executar os movimentos especificados.Consultar resultados da tarefaA geração de vídeo é uma tarefa assíncrona que retorna um
task_id ao ser enviada. Use o endpoint Obter status da tarefa para consultar o progresso e os resultados da geração.