Vídeo
Seedance 2.5 video
Seedance 2.5 — geração de vídeo com áudio sincronizado, referências de imagem, vídeo e áudio. 480p/720p/1080p, 4–30s.
Categoria: Criação · seedance-2-5
Quando escolher
30 segundos num plano contínuo, áudio nativo e até 50 referências. Nenhum outro modelo do catálogo chega perto na duração.
Bom para:
- clipe longo sem emenda — 30s gerados de uma vez, sem costura entre trechos
- áudio nativo que dita ritmo, batida e sincronia labial
- referência pesada: até 30 imagens, 10 vídeos e 10 áudios na mesma geração
- peça que precisa de continuidade absoluta de cena
Evite:
- clipe curto e simples — o preço por segundo não compensa, use seedance-2-fast
- quando precisar de 1080p ou 4K (aqui o teto é 720p)
A duração de plano único é o diferencial e não tem concorrente: enquanto o resto do mercado entrega 5–15s, ele entrega 30s sem emenda. O custo disso na nossa rota é o teto de 720p — pra resolução alta o caminho é o seedance-2.
Alternativas:
seedance-2— O 2 vai a 4K; o 2.5 vai a 30s contínuos e aceita muito mais referência.hailuo-03— H3 lidera em qualidade por clipe curto; 2.5 ganha em duração.
Como usar & limites
- Três modos: texto→vídeo, imagem→vídeo (frame inicial/final) e referência multimodal (imagens, vídeos e áudio).
- Até 30 segundos num plano contínuo — o dobro do Seedance 2.
- image_urls (até 2, frame inicial/final) é mutuamente exclusivo com qualquer campo reference_*.
- reference_image_urls: até 30; reference_video_urls: até 10; reference_audio_urls: até 10 (áudio opcional).
- No modo referência, o total de arquivos (imagem+vídeo+áudio) não passa de 50; cite-os no prompt como @Image1, @Video1, @Audio1.
- Resolução: 480p ou 720p; duração inteira de 4 a 30s; áudio opcional.
Capacidades
O que este modelo suporta, direto do schema — sem preços, sem detalhes de infraestrutura.
| Capacidade | Valor |
|---|---|
video_edit Edição de vídeo | — |
featuredModes FeaturedModes | create |
text_to_video Texto → vídeo | Sim |
image_to_video Imagem → vídeo | Sim |
audio_generation Geração de áudio | Sim |
first_last_frame Frame inicial + final | Sim |
max_prompt_length Tamanho máx. do prompt | 20000 |
reference_to_video Referência → vídeo | Sim |
multimodal_reference Referência multimodal | Sim |
Parâmetros
Campos aceitos em params (ou de primeira classe, quando aplicável) para POST /generations.
| Nome | Rótulo | Tipo | Obrigatório | Padrão | Opções | Mín / Máx | Descrição |
|---|---|---|---|---|---|---|---|
prompt | Prompt | textarea | Obrigatório | — | — | — | Descrição do vídeo. Cite as referências como @Image1, @Video1, @Audio1. |
image_urls | Image references | multi_select | Opcional | — | — | — – 2 | Até 2 imagens (frame inicial/final); exclui os campos reference_*. |
reference_image_urls | Reference images | multi_select | Opcional | — | — | — – 30 | Até 30 imagens de referência; exclui image_urls. |
reference_video_urls | Reference videos | multi_select | Opcional | — | — | — – 10 | Até 10 vídeos de referência; exclui image_urls. |
reference_audio_urls | Reference audio | multi_select | Opcional | — | — | — – 10 | Até 10 áudios (referência de áudio opcional). |
resolution | Resolution | select | Obrigatório | 720p | 480p · 720p | — | Resolução: 480p ou 720p. |
aspect_ratio | Aspect ratio | select | Opcional | 16:9 | auto · 21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16 | — | Proporção: auto (padrão), 1:1, 21:9, 4:3, 3:4, 16:9 ou 9:16. |
duration | Duration | number | Obrigatório | 5 | — | 4 – 30 | Duração em segundos, inteiro de 4 a 30. |
generate_audio | Generate audio | boolean | Opcional | false | — | — | Gera uma trilha de áudio junto ao vídeo. |
Exemplo de requisição
curl -X POST https://caranguejo.art/api/v1/dev/generations \
-H "Authorization: Bearer $CK" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2-5",
"prompt": "Plano-sequência de 20 segundos percorrendo um mercado noturno, câmera na mão, vapor subindo das barracas.",
"params": {
"resolution": "720p",
"duration": 20,
"aspect_ratio": "16:9",
"generate_audio": true
}
}'
const res = await fetch("https://caranguejo.art/api/v1/dev/generations", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.CK,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "seedance-2-5",
"prompt": "Plano-sequência de 20 segundos percorrendo um mercado noturno, câmera na mão, vapor subindo das barracas.",
"params": {
"resolution": "720p",
"duration": 20,
"aspect_ratio": "16:9",
"generate_audio": true
}
}),
});
const { data } = await res.json();
Exemplo de resposta
{
"id": "9f0c1a7e-…",
"object": "generation",
"model": "seedance-2-5",
"type": "video",
"status": "completed",
"output": {
"assets": [
{
"url": "https://media.caranguejo.art/outputs/example.mp4",
"type": "video"
}
]
}
}
O custo real do job é retornado em credits_charged na resposta concluída — consulte GET /balance para o saldo da conta.
Erros comuns deste tipo de job:
insufficient_credits | Saldo insuficiente para cobrir o job. |
content_policy_violation | Prompt ou mídia recusados por política de conteúdo. |
generation_timeout | O job excedeu o tempo máximo de processamento. |
rate_limited | Limite de requisições por minuto excedido. |
invalid_input | Parâmetro obrigatório ausente ou fora do schema do modelo. |
generation_failed | Falha genérica no processamento do job. |