Introdução
O Seedance 2.0 Fast imagem para vídeo começa o clipe numa imagem que você fornece e a anima por até 15 segundos. Adicione uma imagem final e a tomada precisa chegar a ela, o que torna transições e pares de antes e depois repetíveis.
O Seedance 2.0 Fast é o nível rápido da linha Seedance 2.0 da ByteDance. Seus três 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 | Não | Opcional, mas vale escrever: diga o que acontece depois do quadro em vez de repetir o que já está visível — a ação, o movimento de câmera, a passagem do tempo, o som. pelo menos 1 caracteres |
image_url | Sim | Link público e diretamente baixável para o primeiro quadro; obrigatório. |
last_image_url | Não | Quadro final opcional. Ele define a imagem em que a tomada termina: uma transição, um antes e depois, ou um loop que abre e fecha na mesma imagem. |
aspect_ratio | Não | Enquadramento de saída, adaptive por padrão: o clipe mantém as proporções do seu quadro inicial, então nada é cortado. |
resolution | Não | Resolução de saída: 480p ou 720p por padrão. Ela seleciona uma faixa de preço e governa só o formato entregue — não acrescenta detalhe que o primeiro quadro já não tenha. |
duration_seconds | Não | Duração do clipe final em segundos inteiros, de 4 a 15, padrão 5, e a quantidade cobrada; 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
| Especificação | Preço |
|---|---|
| $0.04499712 / segundo |
| $0.096768 / segundo |
Casos de uso
Resultados literais a partir de um quadro próprio
O que o quadro inicial mostra já está no clipe, então o prompt só precisa descrever o movimento e não defender o conteúdo. É o caminho confiável quando o filtro próprio do Seedance recusa a mesma cena escrita como texto.
Antes e depois, e transições
Envie last_image_url junto com image_url e a tomada terá de terminar na imagem final. O exemplo publicado mobilia em dez segundos um cômodo vazio com tapete, sofá e luminárias, com a câmera parada: o formato de uma revelação de reforma ou da transformação de um produto.
Rascunho em 480p, entrega em 720p
Faça passadas baratas em 480p até a ação e o enquadramento funcionarem e depois repita a mesma solicitação em 720p para a tomada que vai ficar. A resolução muda só o formato entregue; não acrescenta detalhe que o primeiro quadro já não tenha.
Guia de prompt e dicas práticas
Prepare o quadro primeiro
image_url define composição, aparência do sujeito, cor e teto de qualidade. Textos, marcas d'água e logotipos passam para o vídeo, então remova-os antes. Cada lado da imagem precisa ter entre 300 e 6000 pixels; fora disso, a solicitação é recusada antes de começar a renderização.
Descreva o que acontece depois, não o que já se vê
O prompt é opcional, mas vale a pena escrever: diga a ação, o movimento de câmera, a passagem do tempo e o som. Uma tomada guiada por um único quadro deriva mais quanto mais dura, então confirme o movimento em 4 ou 5 segundos antes de pagar por 15.
Adapte o exemplo incluído
O exemplo publicado usa aspect_ratio 16:9, duration_seconds 6, generate_audio true e resolution 720p, com a foto de uma fachada de loja como image_url.
A hand reaches into frame and flips the door sign from CLOSED to OPEN, then withdraws; steam drifts off the machine behind the glass and the street reflection keeps moving. Camera stays where it is.
16:9 é indicado explicitamente para um espaço horizontal fixo, em vez de deixar adaptive seguir a imagem. Mantenha a câmera parada e uma única ação clara quando usar seu próprio quadro.
Mantenha os dois quadros no mesmo formato
Ao adicionar last_image_url, dê a ele as mesmas proporções do quadro inicial; se forem diferentes, a imagem final é cortada para combinar. Mantenha câmera e luz estáveis entre os dois e mude um único estado claro, ou o meio do clipe vira um corte.
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/image-to-video",
"input": {
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"duration_seconds": 5,
"generate_audio": true,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise"
}
}'
# 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.
