Seedance 2.5 de referência para vídeo: como usar referências
As referências são como o Seedance 2.5 mantém o mesmo rosto, produto, lugar ou estilo ao longo de um clipe inteiro. Uma solicitação pode levar até 30 imagens de referência, até 10 clipes de referência e até 10 sons de referência, e o prompt diz para que serve cada um.
Limites de referências
| Referência | Campo | Até | Use para |
|---|---|---|---|
| Imagens | image_urls | 30 | Um personagem de vários ângulos, um produto, um local, uma paleta de cores, um quadro de storyboard |
| Clipes de vídeo | video_urls | 10 | Um movimento de câmera, uma atuação ou um movimento para copiar; ou o clipe a editar |
| Sons | audio_urls | 10 | Música para a montagem, uma voz, um efeito sonoro |
As referências são links https públicos, ou arquivos que você envia com POST /v1/uploads (imagens de até 30 MB, clipes de 50 MB, sons de 15 MB). Um primeiro quadro (image_url) é outra coisa: ele fixa a imagem de abertura. Veja imagem para vídeo.
Nomeie cada referência no prompt
O modelo lê as referências na ordem em que você as envia. Cite-as pelo tipo e pelo número e diga para que serve cada uma: “a mulher da imagem 1”, “a garrafa da imagem 3”, “copie o movimento de câmera do vídeo 1”, “a música segue o áudio 1”. Uma referência que você não menciona ainda pode influenciar o visual, então envie só o que a cena precisa.
# One Idempotency-Key per job, made once: resend with the same $KEY after a timeout, a 429 or a 5xx
KEY=$(uuidgen)
curl https://api.revana.si/v1/generations \
-H "Authorization: Bearer $REVANA_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $KEY" \
-d '{
"model": "seedance-2.5",
"input": {
"prompt": "The chef from image 1 plates the dish from image 2 in the kitchen from image 3. Shot 1: wide of the kitchen. Shot 2: close-up of her hands plating. Shot 3: she slides the plate toward camera and smiles. Pans sizzling, low kitchen chatter.",
"image_urls": [
"https://example.com/chef.jpg",
"https://example.com/dish.jpg",
"https://example.com/kitchen.jpg"
],
"duration": 15,
"resolution": "720p",
"aspect_ratio": "16:9",
"audio": true
},
"max_cost_usd": 5
}'Clipes e sons de referência
Um clipe de referência mostra ao modelo um movimento ou um movimento de câmera a seguir; um som dá o ritmo ou a voz a acompanhar. Eles podem ser combinados com imagens na mesma solicitação.
{
"model": "seedance-2.5",
"input": {
"prompt": "Copy the camera move of video 1: a fast dolly through a crowded market, but in a snowy mountain village at dusk. The music follows audio 1.",
"video_urls": [
"https://example.com/dolly-shot.mp4"
],
"audio_urls": [
"https://example.com/track.mp3"
],
"duration": 10,
"resolution": "720p",
"audio": true
},
"max_cost_usd": 5
}Edite um vídeo que você já tem
Envie o clipe em video_urls e descreva só a mudança. Não informe duração nem proporção: a edição mantém as do próprio clipe.
{
"model": "seedance-2.5",
"input": {
"prompt": "Same shot, but it is night and raining, neon reflections on the street",
"video_urls": [
"https://example.com/street.mp4"
]
},
"max_cost_usd": 5
}Para trocar uma pessoa, um produto ou um lugar em um clipe mantendo a mesma atuação e a mesma câmera, o Nemesis foi feito exatamente para isso.
Quanto custam as referências
Imagens de referência não mudam a tarifa: 480p $0.09 · 720p $0.21 · 1080p $0.52 por segundo. Uma solicitação com vídeo de entrada é cobrada pela tarifa menor de vídeo de entrada ($0.06, $0.15 e $0.34 por segundo), e os segundos dos clipes de entrada são cobrados junto com a saída: um clipe de 10 segundos em 720p feito a partir de uma referência de 10 segundos custa $3.00. O endpoint de cotação grátis informa o preço exato de qualquer solicitação.
Dicas para personagens e produtos consistentes
- Vários ângulos, um só sujeito. Três ou quatro imagens do mesmo rosto (de frente, três quartos, perfil) seguram um personagem melhor do que uma só.
- Fundos lisos nas referências de produto e personagem, para o modelo não copiar o fundo também.
- Uma função por referência. Não envie uma imagem que mostre o personagem e o local ao mesmo tempo; separe-os.
- Elenco pequeno. Um ou dois personagens se mantêm consistentes com mais confiabilidade do que uma multidão.
- Rascunhos em 480p ($0.90 por 10 segundos) até as referências ficarem certas, e depois renderize a versão final.
FAQ
Quantas imagens de referência o Seedance 2.5 aceita?
Até 30 imagens de referência por solicitação na Revana, mais até 10 clipes e 10 sons de referência.
Qual a diferença entre uma imagem de referência e um primeiro quadro?
Um primeiro quadro (image_url) é a imagem exata de abertura do clipe. As imagens de referência (image_urls) orientam quem e o que aparece, e com que aparência, sem fixar nenhum quadro.
O Seedance 2.5 aceita referências de áudio?
Sim. Envie até 10 sons em audio_urls e diga no prompt para que serve cada um, como a música para a montagem.
As referências custam a mais?
As imagens de referência, não. Clipes de referência mudam a solicitação para a tarifa de vídeo de entrada ($0.15 por segundo em 720p) e os segundos deles são cobrados junto com a saída.
Crie seu primeiro vídeo com o Seedance 2.5
Uma única chave de API para o Seedance 2.5 e todos os outros modelos de vídeo e imagem. Crédito pré-pago a partir de $10, crédito grátis de cadastro, sem assinatura e só os clipes entregues são cobrados.