Introdução
O Seedance 2.0 Fast texto para vídeo monta o quadro inteiro a partir do prompt — sujeito, cenário, câmera, luz — e gera a trilha sonora na mesma passada. Nada ancora a imagem, então este é o endpoint para uma tomada que ainda não existe.
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 | A única fonte do que aparece na tela. Ordene como sujeito, ação, câmera, luz, som, uma ideia por frase. pelo menos 1 caracteres |
aspect_ratio | Não | Enquadramento de saída: adaptive por padrão, ou uma de seis proporções fixas, de 21:9 a 9:16. |
resolution | Não | Resolução de saída: 480p ou 720p por padrão. Ela seleciona uma faixa de preço, e faixas mais altas significam arquivos maiores e renderizações mais longas. |
duration_seconds | Não | Duração do clipe final em segundos inteiros, de 4 a 15, padrão 5, e a quantidade cobrada — o custo acompanha diretamente. |
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: |
enable_web_search | Não | Desligado por padrão. Quando ligado, o modelo pode buscar na web informações relacionadas ao seu prompt antes de renderizar. 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 |
| $0.0702 / segundo |
| $0.1488 / segundo |
Casos de uso
Cortes verticais para redes sociais
Peça 9:16 diretamente e escreva a tomada como um celular a veria: câmera na mão, luz do dia pela janela, ruído ambiente mantido. O exemplo abaixo é exatamente isso: cinco segundos na janela de um ônibus, gerados a partir de um prompt sem nenhuma filmagem por trás.
Tomadas que ninguém vai filmar
Sem imagem para seguir, o prompt é a única fonte de sujeito, cenário, câmera e luz. Por isso é o endpoint para planos de ambientação, inserts e b-roll que, de outro jeito, exigiriam locação e equipe.
A primeira tomada de uma sequência mais longa
Esta linha não tem endpoint para estender clipes. Gere aqui a tomada de abertura, exporte o último quadro e envie para imagem para vídeo como início da próxima tomada; figurino, cenário e luz continuam porque estão gravados nesse quadro.
Guia de prompt e dicas práticas
Organize o prompt como uma lista de tomadas
Sujeito, ação, câmera, luz, som: uma ideia por frase. Os segundos extras de um duration_seconds mais longo servem para concluir uma ação, não para encaixar uma segunda ideia; peças longas se constroem encadeando tomadas.
Saiba onde atua o filtro próprio do Seedance
Nada é revisado do nosso lado, mas a camada de segurança própria do Seedance recusa parte da redação antes de renderizar um único quadro. O beijo é o gatilho constante, enquanto um sussurro no ouvido ou testas encostadas passam. Se você precisa de um resultado literal, conduza a cena a partir de um primeiro quadro em imagem para vídeo.
Adapte o exemplo incluído
O exemplo publicado usa aspect_ratio 9:16, duration_seconds 5, generate_audio true e resolution 720p.
Vertical selfie video: an adult woman on a city bus by the window, pale blue mohair cardigan slipping off one shoulder, hair in a lace headband, she tilts the phone, winks and flashes a peace sign, then laughs and looks away. Bright overcast daylight through the window, street sliding past, authentic handheld phone-camera look, ambient bus noise.
O prompt pede o realismo de uma câmera de celular em vez de cinema, e é isso que convence como selfie. Mantenha esse registro e troque a pessoa, o lugar e o gesto.
Rascunhe em 480p, compare com seed fixo
Itere em 480p enquanto a redação ainda muda e suba resolution para 720p só na tomada que vai ficar. Para ver o que uma edição do prompt realmente mudou, fixe seed e mantenha todos os outros campos iguais; é uma ferramenta de comparação, não uma promessa de repetições idênticas quadro a quadro. Com duration_seconds em -1, a estimativa considera 15 segundos e a cobrança segue a duração entregue.
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/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"generate_audio": true,
"duration_seconds": 5
}
}'
# 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.
















