Guia · referências

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

Limites de referências do Seedance 2.5 na Revana
ReferênciaCampoAtéUse para
Imagensimage_urls30Um personagem de vários ângulos, um produto, um local, uma paleta de cores, um quadro de storyboard
Clipes de vídeovideo_urls10Um movimento de câmera, uma atuação ou um movimento para copiar; ou o clipe a editar
Sonsaudio_urls10Mú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.

cURL
# 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.

JSON
{
  "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.

JSON
{
  "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.