Introdução
O Seedance 2.0 reference-to-video concilia várias fontes autorizadas em um único plano: imagens para quem e o quê, clipes para movimento e ritmo, áudio para a batida em que o corte cai. É um contrato separado e não aceita primeiro quadro.
O Seedance 2.0, da ByteDance, publica text-to-video, image-to-video e reference-to-video: clipes de 4 a 15 segundos de 480p a 4K, com áudio nativo e enquadramento adaptive por padrão.
| Material inicial | Modo indicado |
|---|---|
| Cena escrita | Seedance 2.0 Texto para vídeo |
| Imagem inicial aprovada | Seedance 2.0 Imagem para vídeo |
| Referências separadas | Seedance 2.0 Referências para vídeo |
Recursos e destaques
O ruído do ambiente volta no mesmo arquivo
generate_audio vem ligado, então gelo numa coqueteleira, uma risada, conversa baixa de bar e a sala em que tudo acontece saem da mesma passada que a imagem. O resultado chega já em sincronia em vez de esperar por uma passada de som. Desligue quando o clipe vai para um designer de qualquer jeito.
Nove referências e um elenco que não muda
O reference-to-video aceita até 9 imagens, 3 clipes e 3 faixas de áudio juntos. Três ângulos de um rosto mais um still de figurino seguram um personagem ao longo de um episódio muito melhor que nove quadros sem relação, e um clipe de referência carrega linguagem de câmera que nenhum adjetivo num prompt reproduz de forma confiável.
A forma segue o material
aspect_ratio vem em adaptive nos três endpoints. No image-to-video o clipe mantém a forma da sua imagem de abertura, então um retrato não é cortado para paisagem; no text-to-video o modelo tira a forma do prompt; no reference-to-video ele encontra um quadro que acomoda todos os sujeitos referenciados. Informe 16:9, 9:16 ou 21:9 só quando um posicionamento exigir formato fixo.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório, e aqui ele também faz o casting. |
reference_image_urls | Não | Até 9 imagens de referência, usadas para segurar um personagem, um estilo ou um cenário. no máximo 9 itens |
reference_video_urls | Não | Até 3 clipes de referência, cada um com 2 a 15 segundos e no máximo 15 segundos somados, fornecendo movimento, ritmo ou linguagem de câmera. no máximo 3 itens |
reference_audio_urls | Não | Até 3 arquivos de áudio de referência, cada um com 2 a 15 segundos e no máximo 15 segundos somados, dando ao modelo uma âncora sonora — interpretação, andamento, uma frase music… no máximo 3 itens |
aspect_ratio | Não | Vem em |
resolution | Não | 480p, 720p, 1080p ou 4k, padrão 720p, e alimenta a quantidade cobrada diretamente. Define só a faixa de saída e não vai deixar referências de baixa resolução mais nítidas. |
duration_seconds | Não | De 4 a 15 segundos, padrão 5; com -1, o modelo escolhe a duração (a estimativa usa o máximo de 15 segundos e a cobrança, a duração entregue). |
generate_audio | Não | Ligado por padrão. Produz uma trilha nativa sincronizada com a imagem. Valor padrão: |
seed | Não | Seed inteiro; omita e cada execução sorteia o seu. Fixe com todo o resto constante para julgar o que uma edição de prompt realmente mudou. |
return_last_frame | Não | Devolve também o último quadro do clipe como imagem separada, junto com o vídeo. Valor padrão: |
bitrate_mode | Não | Taxa de bits do arquivo entregue: |
watermark | Não | Adiciona ao vídeo a marca-d’água visível “AI generated” do próprio modelo. Valor padrão: |
Preços
Os clipes de referência entram na contagem de segundos cobrados. Como não é possível medir seus clipes antes da execução, reservamos antecipadamente o valor dos 15 segundos máximos e liberamos a parte não utilizada assim que a cobrança é fechada — você paga apenas pelos segundos realmente usados.
| Resolução | With video: Sim | With video: Não |
|---|---|---|
| $0.0431 / segundo | $0.07 / segundo |
| $0.0928 / segundo | $0.152 / segundo |
| $0.2284 / segundo | $0.374 / segundo |
| $0.778 / segundo | $0.778 / segundo |
Casos de uso
Dê uma função a cada referência
O Seedance 2.0 reference-to-video concilia várias fontes autorizadas em um único plano: imagens para quem e o quê, clipes para movimento e ritmo, áudio para a batida em que o corte cai. É um contrato separado e não aceita primeiro quadro. Use este modo quando imagens, clipes ou áudios separados devem orientar partes diferentes de um novo plano. Identifique o que cada recurso contribui antes de pedir a ação que os conecta.
Cena noturna e de bar que já vem com o próprio som
Um coquetel sendo batido, vidro no balcão, conversa baixa atrás de uma lanterna vermelha: escreva a sala no prompt e deixe generate_audio ligado. O Seedance 2.0 renderiza a ambiência contra a imagem, então o corte chega com atmosfera em vez de uma chapa muda.
Continuidade da campanha em toda a leva de cortes
Carregue o produto em três ângulos e a modelo em dois no reference-to-video, e depois mude só o prompt para cada corte. O mesmo frasco, o mesmo rosto e a mesma jaqueta viajam com a requisição, então o conjunto se segura sem uma passada manual de tratamento de cor.
Trabalho de fantasia e de RPG, sem censura
Renda e cetim, adereços de cauda e orelhas, enquadramento em primeira pessoa, casais de qualquer gênero: nada disso é revisado do nosso lado. A camada do próprio Seedance recusa algumas formulações, então dirija essas cenas a partir de um primeiro quadro no image-to-video, e não do prompt.
Guia de prompt e dicas práticas
Escolha o endpoint pelo que você já tem
Só uma descrição vai para o text-to-video. Um still que precisa sobreviver vai para o image-to-video. Um elenco, um produto ou um movimento que tem de se repetir entre cortes vai para o reference-to-video. Chamando pelo nome da família, são os campos que você manda que escolhem o endpoint.
Escreva o plano como uma decupagem
Sujeito, ação, câmera, luz, som, uma ideia por frase. O clipe desta página saiu exatamente deste texto: “Photorealistic live-action, not animation. A real adult woman in a chocolate satin robe works behind a dim neon bar, a large fluffy faux fox tail accessory clipped at the small of her back. She shakes a cocktail, turns to set the glass on the counter and the tail sways with the movement, then she looks back at camera with a teasing smile. Warm red lantern light, 35mm grain, slow push-in, ice rattling and low bar chatter.” Cinco segundos, 720p, 16:9, áudio ligado.
Adapte o exemplo publicado
Comece pelo exemplo publicado e mantenha as entradas próprias deste modo. Troque só o assunto e a direção criativa; compare a próxima tomada com um objetivo visual claro.
The woman from @Image1, in the same sheer black robe, steps out onto the rooftop from @Image2 at sunset. She walks slowly between the drying white sheets; the wind lifts one sheet across her body and lets it fall away. She stops at the parapet, the robe sliding off one shoulder, and glances back over her shoulder into camera. Warm golden backlight, slow tracking shot, no cuts.
Uma referência é a pessoa e a outra é o lugar: o prompt diz qual imagem faz o quê. Assim, a mulher do retrato à luz de velas chega ao terraço ao pôr do sol com o mesmo robe, e os lençóis no varal viram aquilo por onde ela passa.
Revise o resultado e itere com intenção
Confira se cada referência cumpre o papel previsto: personagem, ambiente, movimento ou som. Se houver conflito, retire primeiro uma fonte contraditória em vez de sobrecarregar o prompt.
Defina o ponto de partida e o resultado
Antes de gerar, decida o que precisa aparecer no começo, durante a mudança e no fim. Assim, você avalia a sequência contra um objetivo concreto, e não contra uma impressão vaga.
Avalie separadamente a fonte e o movimento
A imagem de origem fixa os detalhes reconhecíveis; a instrução descreve o que acontece depois. Revise as duas decisões juntas para que o movimento não apague a composição inicial.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedance-2.0/reference-to-video",
"input": {
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"duration_seconds": 5,
"generate_audio": true,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"reference_image_urls": [
"https://example.com/reference.png"
]
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
















