Geração de Vídeos de Dança Seedance
Gere vídeos de dança e movimento com IA através da API Seedance (ByteDance) da AceDataCloud.
Configuração: Consulte autenticação para configuração do token.
Início Rápido
curl -X POST https://api.acedata.cloud/seedance/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"model": "doubao-seedance-2-0-260128", "content": [{"type": "text", "text": "um dançarino performando balé contemporâneo em uma floresta nebulosa"}], "callback_url": "https://api.acedata.cloud/health"}'
Assíncrono: Consulte polling de tarefas assíncronas. Faça polling via
POST /seedance/taskscom{"id": "..."}. Isso retorna um ID de tarefa imediatamente. Faça polling pelo resultado:
curl -X POST https://api.acedata.cloud/seedance/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<task_id do comando acima>"}'
Modelos
Seedance 2.0 (geração atual — referência multimodal)
A série 2.0 adiciona entradas de referência multimodal: referências de imagem de pessoa real/personagem, áudio de referência e vídeo de referência (veja os fluxos de trabalho abaixo).
| Modelo | Melhor para | Resolução máxima |
|---|---|---|
doubao-seedance-2-0-260128 | Maior qualidade, referência de pessoa real/personagem, saída 4k | 4k |
doubao-seedance-2-0-fast-260128 | Geração 2.0 mais rápida | 720p |
doubao-seedance-2-0-mini-260615 | Leve / 2.0 mais econômico | 720p |
Seedance 1.x
| Modelo | Tipo | Melhor para |
|---|---|---|
doubao-seedance-1-5-pro-251215 | Texto+Imagem-para-Vídeo | Flagship 1.5, suporte a áudio |
doubao-seedance-1-0-pro-250528 | Texto+Imagem-para-Vídeo | Uso geral, qualidade confiável |
doubao-seedance-1-0-pro-fast-251015 | Texto+Imagem-para-Vídeo | Geração Pro mais rápida |
doubao-seedance-1-0-lite-t2v-250428 | Somente Texto-para-Vídeo | Texto-para-vídeo leve |
doubao-seedance-1-0-lite-i2v-250428 | Somente Imagem-para-Vídeo | Imagem-para-vídeo leve |
Fluxos de Trabalho
1. Texto-para-Vídeo
Passe um item de conteúdo de texto no array content.
POST /seedance/videos
{
"model": "doubao-seedance-1-0-pro-250528",
"content": [
{"type": "text", "text": "um dançarino de rua fazendo movimentos de breakdance em um ambiente urbano"}
],
"resolution": "1080p",
"ratio": "16:9",
"duration": 5
}
2. Imagem-para-Vídeo
Inclua um item de conteúdo de imagem (com um role opcional) junto com o texto.
POST /seedance/videos
{
"model": "doubao-seedance-1-5-pro-251215",
"content": [
{"type": "text", "text": "a pessoa começa a dançar graciosamente"},
{
"type": "image_url",
"role": "first_frame",
"image_url": {"url": "https://exemplo.com/dancarino.jpg"}
}
],
"resolution": "720p",
"duration": 5
}
Papéis das imagens:
first_frame— a imagem é usada como quadro iniciallast_frame— a imagem é usada como quadro finalreference_image— a imagem é usada como referência de estilo/sujeito/pessoa real (Seedance 2.0 mantém a pessoa ou personagem referenciada consistente)
Mídia de referência (apenas Seedance 2.0):
audio_url— áudio de referência para timbre de voz / música de fundo (semrole)video_url— vídeo de referência para sujeito, movimento de câmera, movimento ou estilo geral (semrole)
3. Primeiro-quadro + Último-quadro
Forneça imagens de quadro inicial e final:
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "transição suave entre duas cenas"},
{"type": "image_url", "role": "first_frame", "image_url": {"url": "https://exemplo.com/inicio.jpg"}},
{"type": "image_url", "role": "last_frame", "image_url": {"url": "https://exemplo.com/fim.jpg"}}
]
}
4. Referência de pessoa real / personagem (Seedance 2.0)
Os modelos Seedance 2.0 (doubao-seedance-2-0-260128, doubao-seedance-2-0-fast-260128, doubao-seedance-2-0-mini-260615) podem manter uma pessoa ou personagem específica consistente em uma nova cena. Passe uma ou mais fotos como itens image_url com role: "reference_image" — o modelo preserva a aparência desse sujeito. São aceitas até 9 imagens de referência.
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "a mesma pessoa andando por um mercado noturno iluminado por neon, cinematográfico"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://exemplo.com/pessoa.jpg"}}
],
"resolution": "1080p",
"duration": 8
}
5. Áudio / Vídeo de referência (Seedance 2.0)
Os modelos 2.0 também aceitam áudio de referência (timbre de voz, música de fundo) e vídeo de referência (conteúdo do sujeito, movimento de câmera, movimento, estilo geral). Adicione itens de conteúdo audio_url e/ou video_url. Limites: até 3 referências de áudio e 3 de vídeo por requisição.
POST /seedance/videos
{
"model": "doubao-seedance-2-0-260128",
"content": [
{"type": "text", "text": "um cantor performando no palco, combinando com a voz e movimento de referência"},
{"type": "image_url", "role": "reference_image", "image_url": {"url": "https://exemplo.com/pessoa.jpg"}},
{"type": "audio_url", "audio_url": {"url": "https://exemplo.com/voz.mp3"}},
{"type": "video_url", "video_url": {"url": "https://exemplo.com/movimento.mp4"}}
],
"generate_audio": true
}
Parâmetros
| Parâmetro | Valores | Descrição |
|---|---|---|
model | veja tabela Modelos | Modelo a ser usado (obrigatório) |
content | array | Itens de entrada: text, image_url, audio_url (2.0), video_url (2.0) (obrigatório) |
resolution | "480p", "720p", "1080p", "4k" | Resolução de saída. 4k é apenas para doubao-seedance-2-0-260128 (padrão); 2-0-fast / 2-0-mini máximo em 720p (padrão: 720p para pro/2.0, 480p para lite) |
ratio | "16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive" | Proporção de tela (padrão: 16:9) |
duration | 2 – 15 | Duração em segundos (Seedance 2.0 suporta 4–15) |
frames | 29–361 (deve satisfazer 25+4n) | Contagem de quadros — mutuamente exclusivo com duration |
seed | -1 a 4294967295 | Semente para resultados reproduzíveis (-1 = aleatório) |
generate_audio | true / false | Gerar áudio (suportado por doubao-seedance-1-5-pro-251215 e pela série doubao-seedance-2-0; outros modelos ignoram) |
camerafixed | true / false | Fixar a posição da câmera durante a geração |
watermark | true / false | Adicionar marca d'água ao vídeo gerado |
return_last_frame | true / false | Retornar o último quadro do vídeo gerado |
service_tier | "default", "flex" | Nível de processamento (padrão: default) |
execution_expires_after | número | Limite de tempo limite da tarefa em segundos |
Sintaxe de Parâmetros em Linha
Você também pode incorporar parâmetros de geração diretamente no prompt de texto usando a sintaxe --param valor:
Um gatinho bocejando para a câmera. --rs 720p --rt 16:9 --dur 5 --fps 24 --seed 42
Parâmetros em linha suportados: --rs (resolução), --rt (proporção), --dur (duração), --frames, --fps (apenas 24), --seed, --cf (camera_fixed), --wm (marca d'água).
Armadilhas
- Nomes de modelo usam a convenção
doubao-*(ex:doubao-seedance-1-0-pro-250528) — nomes curtos antigos comoseedance-1.0não são válidos - O array
contentsubstitui os campos antigosprompt+image_url; sempre usecontent - Cenários de imagem e texto são mutuamente exclusivos por item de conteúdo — cada item tem
textouimage_url, não ambos first_frameelast_framepodem ser combinados em uma requisição, masreference_imageé mutuamente exclusivo comfirst_frame/last_frame— não misture uma imagem de referência com primeiro/último quadrosgenerate_audio: trueé suportado pordoubao-seedance-1-5-pro-251215e pela sériedoubao-seedance-2-0; outros modelos ignoram este campo- Modelos Lite são divididos:
*-lite-t2v-*aceita apenas texto,*-lite-i2v-*aceita apenas imagem-para-vídeo - Itens de referência
audio_urlevideo_urlsão usados apenas pela série Seedance 2.0 - Opções de resolução são
480p,720p,1080pe4k(4ké apenasdoubao-seedance-2-0-260128;2-0-fast/2-0-minimáximo em720p) — não há 360p ou 540p - Valores de
service_tiersão"default"e"flex"(não "standard"/"premium") - Faixa de duração é 2–15 segundos (Seedance 2.0 suporta 4–15) — valores fora deste intervalo falharão
- Estados de tarefa usam
"succeeded"(não "completed") — verifique este valor ao fazer polling
MCP:
pip install mcp-seedance| Hospedado:https://seedance.mcp.acedata.cloud/mcp| Veja todos os servidores MCP