Introdução
O Seedance 2.0 Mini 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. É o endpoint para tomadas que ninguém vai filmar.
O Seedance 2.0 Mini é o menor nível da linha Seedance 2.0 da ByteDance. Ele publica os mesmos endpoints do Seedance 2.0 Fast e devolve clipes de 4 a 15 segundos em 480p ou 720p, com áudio gerado na mesma passada.
Escolha o modo do Seedance 2.0 Mini pelo material inicial
| Material inicial | Modo |
|---|---|
| Um roteiro ou a descrição de uma cena | Seedance 2.0 Mini Texto para vídeo |
| Uma imagem inicial aprovada | Seedance 2.0 Mini Imagem para vídeo |
| Referências separadas de aparência, movimento ou áudio | Seedance 2.0 Mini Referências para vídeo |
Recursos e destaques
O mesmo contrato do Seedance 2.0 Fast
O Mini publica os mesmos endpoints e campos do Seedance 2.0 Fast: formato adaptativo mais seis proporções fixas, de 4 a 15 segundos ou -1 para o modelo escolher a duração, áudio nativo e seed, com resolução limitada a 720p. Um pipeline escrito para o Mini passa para o Fast trocando o id do modelo, não a solicitação.
Feito para volume
O Mini é o nível certo quando vazão importa mais que a qualidade extra dos modelos Seedance 2.0 maiores. Todos os endpoints são assíncronos: envie um Idempotency-Key em cada solicitação, guarde os ids das tarefas e deixe o polling ou os callbacks resolverem. A chave vale por 24 horas, então uma nova tentativa depois de uma conexão caída devolve a tarefa original.
Sequências mais longas com a extensão de vídeo
Para passar de quinze segundos, envie um clipe pronto ao endpoint video-extend: o último quadro dele abre uma nova tomada do Seedance 2.0 Mini e você recebe um único arquivo com as duas partes unidas. Cada passo cobra só os segundos que acrescenta, e o resultado unido pode ser estendido de novo.
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.0246078 / segundo |
| $0.05292 / segundo |
Casos de uso
B-roll do dia a dia em volume
Luz da manhã pela janela, um edredom puxado sobre o rosto, poeira num raio de sol: as tomadas comuns de que um catálogo ou um app precisa às centenas e para as quais ninguém quer marcar uma filmagem. O exemplo publicado abaixo é exatamente isso, gerado só com um prompt.
Um briefing em todos os formatos
Fixe o prompt e distribua em 16:9, 9:16 e 1:1 no mesmo lote. Como o endpoint é assíncrono, três formatos da mesma ideia são três ids de tarefa para coletar, não três trabalhos para planejar.
Muitos visuais com o mesmo formato de solicitação
Os mesmos campos cobrem live action e animação estilizada. Entre os exemplos deste endpoint há uma rua encharcada de chuva à noite com teleobjetiva e uma cena de anime em cel shading numa fonte termal com neve; o visual é definido no prompt, sem campo extra.
Guia de prompt e dicas práticas
Sujeito, ação, câmera, luz, som
Uma ideia por frase, nessa ordem. Quando um duration_seconds maior der tempo extra, use-o para concluir a ação já descrita em vez de acrescentar outra.
Reescreva o que o Seedance recusa
Não revisamos a redação, mas a camada própria do Seedance recusa parte dela antes de renderizar, e o beijo é o gatilho constante. A mesma cena escrita como um sussurro no ouvido ou testas encostadas passa, e um primeiro quadro em imagem para vídeo leva a versão literal.
Adapte o exemplo incluído
O exemplo publicado usa aspect_ratio 16:9, duration_seconds 5, generate_audio true e resolution 720p.
Morning in a sunlit studio apartment. An adult woman in an oversized grey t-shirt stretches her arms overhead beside the window, the hem lifting slightly, then drops onto the unmade bed and pulls the duvet over her face laughing. Warm dust in the light shaft, handheld, soft film grain, quiet room tone and distant traffic.
Material comum, com câmera na mão e som ambiente de quarto silencioso: exatamente para isso existe este nível. Troque o cômodo e o gesto e mantenha a estrutura de uma só ação.
Desligue o áudio só se for sonorizar depois
Desligar generate_audio não muda a tarifa neste nível. Deixe ligado quando a ambiência sustenta a cena e desligue para loops mudos ou quando a música entrar na pós.
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-mini/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.
















