Introdução
O Seedance 2.0 Fast referências para vídeo reúne várias fontes autorizadas numa única tomada: imagens para quem e o quê, clipes para movimento e ritmo, áudio para a batida em que o corte cai. Ele não recebe primeiro quadro.
O Seedance 2.0 Fast é o nível rápido da linha Seedance 2.0 da ByteDance. Seus endpoints devolvem clipes de 4 a 15 segundos em 480p ou 720p, com áudio gerado junto com a imagem.
Escolha o modo do Seedance 2.0 Fast pelo material inicial
| Material inicial | Modo |
|---|---|
| Um roteiro ou a descrição de uma cena | Seedance 2.0 Fast Texto para vídeo |
| Uma imagem inicial aprovada | Seedance 2.0 Fast Imagem para vídeo |
| Referências separadas de aparência, movimento ou áudio | Seedance 2.0 Fast Referências para vídeo |
Recursos e destaques
Um conjunto de campos, três fontes
Os três endpoints aceitam os mesmos campos básicos: prompt, duration_seconds de 4 a 15 (ou -1 para o modelo escolher), resolution em 480p ou 720p, aspect_ratio, generate_audio e seed. O que muda é a fonte que ancora a imagem: nenhuma, um quadro inicial ou um conjunto de referências. Uma solicitação passa de um modo para outro só acrescentando ou tirando essa fonte.
Imagem e som na mesma passada
generate_audio vem ligado e gera ambiência, efeitos de movimento e voz sincronizados com os quadros. Desligar não reduz a tarifa neste nível, então desligue só para loops mudos ou para material que você vai sonorizar na pós.
Formato adaptativo por padrão
aspect_ratio usa adaptive por padrão: imagem para vídeo mantém as proporções do quadro inicial, referências para vídeo segue a referência principal e texto para vídeo deixa o modelo escolher a forma sugerida pelo prompt. As seis proporções fixas, 16:9, 9:16, 4:3, 3:4, 1:1 e 21:9, estão lá quando o destino impõe o formato.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório, e aqui ele também faz o casting. pelo menos 1 caracteres |
reference_image_urls | Não | Até 9 imagens que você tem autorização para usar, para um personagem, um produto, um estilo ou um cenário. no máximo 9 itens |
reference_video_urls | Não | Até 3 clipes que trazem movimento, ritmo ou linguagem de câmera. no máximo 3 itens |
reference_audio_urls | Não | Até 3 arquivos de áudio, de 2 a 15 segundos cada e 15 no total, cada um abaixo de 15 MB, que dão à tomada uma âncora sonora — entonação, andamento, uma frase musical — com a qua… no máximo 3 itens |
aspect_ratio | Não | Enquadramento de saída, adaptive por padrão: o clipe assume a forma da referência principal. |
resolution | Não | Resolução de saída: 480p ou 720p por padrão. Ela seleciona uma faixa de preço e não vai deixar referências de baixa resolução mais nítidas. |
duration_seconds | Não | Duração do clipe final em segundos inteiros, de 4 a 15, padrão 5; com -1 o modelo escolhe e a estimativa considera 15 segundos. |
generate_audio | Não | Se uma trilha nativa é renderizada em sincronia com a imagem. Vem ligada; desligar não reduz a tarifa nesta versão. 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.022539 / segundo | $0.04499712 / segundo |
| $0.048471 / segundo | $0.096768 / segundo |
Casos de uso
Um produto de todos os ângulos
Dois ou três ângulos do mesmo objeto o sustentam muito melhor do que uma pilha de imagens quase iguais. O exemplo publicado envia três vistas de um tênis e pede uma rotação em base giratória por essas vistas, em ordem, mantendo idênticos a textura do couro, a sola e o cadarço.
Um movimento de câmera emprestado
Um clipe de referência pode trazer linguagem de câmera em vez de conteúdo. Um dos exemplos tira de um clipe a subida lenta de uma grua, encena sobre um terraço de uma imagem de referência e faz o ponto mais alto coincidir com o crescendo de uma faixa de referência.
Um elenco fixo ao longo de uma série
Mantenha um conjunto de referências para um personagem, uma peça de roupa ou um ambiente e mude só o prompt entre as solicitações. As mesmas imagens sustentam cada episódio, então a identidade se mantém enquanto a ação avança.
Guia de prompt e dicas práticas
Faça o elenco no prompt
Aqui o prompt é obrigatório e faz a escalação. As referências são lidas na ordem em que você envia, então diga qual imagem é cada personagem, o que cada clipe contribui e para que serve o áudio. Chamá-las de @Image1, @Image2 e assim por diante deixa essa relação sem ambiguidade.
Respeite os limites de referências
reference_image_urls aceita até 9 imagens, reference_video_urls até 3 clipes e reference_audio_urls até 3 faixas. É preciso ao menos uma imagem ou clipe, porque áudio sozinho é recusado. Clipes e áudio duram de 2 a 15 segundos cada e 15 segundos no total, e os segundos dos seus clipes de referência são cobrados além da saída, então corte-os só no trecho que interessa.
Adapte o exemplo incluído
O exemplo publicado usa aspect_ratio 1:1, duration_seconds 5, generate_audio true e resolution 720p, com três fotos do produto em reference_image_urls.
Treat @Image1, @Image2 and @Image3 as three angles of one sneaker. Rotate it smoothly on an invisible turntable through those three views in order, keeping the leather grain, gum sole and lacing identical throughout. Hard studio key stays fixed; the contact shadow swings with the rotation.
Cada referência é nomeada pela posição e recebe uma única tarefa. Troque o produto e mantenha essa estrutura.
Use imagem para vídeo quando o primeiro quadro precisar ser exato
Este endpoint não tem campo de primeiro nem de último quadro. Quando a imagem de abertura precisar corresponder exatamente a uma foto, envie essa foto para imagem para vídeo e descreva só o movimento.
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-fast/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.
















