
A Seedance 2.5 API no PoYo tem dois IDs de modelo: seedance-2.5-flash para a Seedance 2.5 Flash API, lançada pela ByteDance a 12 de novembro de 2026, e seedance-2.5 para o modelo standard. Partilham um endpoint e um formato de pedido, por isso a escolha é uma decisão de encaminhamento por pedido: resolução, número de referências, custo e rapidez com que precisas do resultado. Esta comparação foi verificada com as duas páginas de documentação a 16 de novembro de 2026.
O mesmo pedido à Seedance 2.5 API, dois IDs de modelo
Os dois modelos são submetidos a POST https://api.poyo.ai/api/generate/submit e lidos a partir de GET /api/generate/status/{task_id} ou de um callback_url. Os campos de entrada têm os mesmos nomes e significados:
| Campo | seedance-2.5-flash | seedance-2.5 |
|---|---|---|
prompt | Obrigatório | Obrigatório |
duration | Obrigatório, inteiro 4–30 | Obrigatório, inteiro 4–30 |
resolution | Opcional: 480p, 720p (predefinição 720p) | Obrigatório: 480p, 720p, 1080p |
aspect_ratio | auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Os mesmos sete valores |
generate_audio | Booleano, predefinição true | Booleano |
image_urls | Primeiro frame + último frame opcional; aspect_ratio auto | Igual |
reference_image_urls | Até 10 | Até 30 |
reference_video_urls | Até 5 | Até 10 |
reference_audio_urls | Até 5, requer uma imagem ou um vídeo de referência | Até 10, requer uma imagem ou um vídeo de referência |
Em ambos, image_urls não se pode combinar com os campos de referência, as referências são indicadas no prompt como @Image1, @Video1, @Audio1, e todos os URLs de multimédia têm de ser públicos e descarregáveis diretamente. A única armadilha do esquema: resolution é opcional no Flash, mas obrigatório no seedance-2.5. Se o teu cliente depende da predefinição de 720p do Flash, acrescenta resolution explicitamente antes de encaminhares um pedido para o modelo standard.
Limites que diferem
| Limite | Flash | Standard |
|---|---|---|
| Resolução de saída | 480p, 720p | 480p, 720p, 1080p |
| Duração por geração | 4–30 s | 4–30 s |
| Imagens / vídeos / áudio de referência | 10 / 5 / 5 | 30 / 10 / 10 (máximo de 50 ficheiros) |
| Velocidade de geração | Quase duas vezes mais rápido, segundo a ByteDance | Base de referência |
A documentação do Flash publica também regras por ficheiro: imagens JPEG, PNG ou WebP até 30 MB; vídeos de referência MP4 ou MOV, 2–30 s e até 200 MB cada, no máximo 30 s combinados; áudio de referência MP3 ou WAV, 2–30 s e até 15 MB cada, no máximo 30 s combinados. A página da documentação do Seedance 2.5 não indica tamanhos por ficheiro, por isso não assumas um limite de ficheiros maior no modelo standard.
Preço por pedido idêntico
O mesmo corpo, mudando apenas o ID do modelo. 1 crédito = $0.005; o áudio gerado é gratuito em ambos.
| Pedido | seedance-2.5-flash | seedance-2.5 | Poupança com o Flash |
|---|---|---|---|
| 5 s, 480p | 92.5 créditos ($0.4625) | 140 créditos ($0.70) | 33.9% |
| 10 s, 480p | 185 créditos ($0.925) | 280 créditos ($1.40) | 33.9% |
| 10 s, 720p | 410 créditos ($2.05) | 630 créditos ($3.15) | 34.9% |
| 30 s, 720p | 1,230 créditos ($6.15) | 1,890 créditos ($9.45) | 34.9% |
| 30 s, 1080p | Não suportado | 3,420 créditos ($17.10) | — |
| 10 s, 720p + um vídeo de referência de 10 s | 510 créditos ($2.55) | 760 créditos ($3.80) | 32.9% |
Com um vídeo de referência, ambos os modelos faturam os segundos de saída mais a duração de cada vídeo de referência arredondada por defeito, à tarifa mais baixa com vídeo (Flash 11,5 / 25,5 créditos; standard 17 / 38 / 68,5 créditos em 480p / 720p / 1080p). O artigo sobre os preços da Seedance 2.5 API tem a tabela completa, as tarifas publicadas da fal e fluxos de trabalho calculados.
Velocidade: a afirmação da ByteDance e os tempos medidos pelo PoYo
A ByteDance descreve o Seedance 2.5 Flash como capaz de entregar resultados próximos dos do Seedance 2.5 topo de gama com quase o dobro da velocidade de geração. Essa é a afirmação do fornecedor; a ByteDance não publicou a configuração de teste por trás dela numa página que conseguíssemos ler.
O que o PoYo mediu a 16 de novembro de 2026, de ponta a ponta através da API, no seedance-2.5-flash:
| Pedido | Tempo até finished |
|---|---|
| 4 s, 480p | Cerca de 2 minutos |
| 30 s, 720p | Menos de 3 minutos |
Não corremos um teste de tempos equivalente no seedance-2.5, por isso este artigo não apresenta uma aceleração medida. Os tempos variam com a carga. Em qualquer dos casos, desenha para assincronia: a documentação de estado indica tempos típicos de geração de vídeo de 90–300 segundos, demasiado longos para manter aberto um pedido HTTP síncrono.
Que ID de modelo chamar, por caso de uso
| Caso de uso | ID do modelo | Razão |
|---|---|---|
| Teste de prompts, variantes A/B | seedance-2.5-flash em 480p | 18,5 créditos por segundo, a tarifa mais baixa do Seedance 2.5 |
| Clips para redes sociais em grande volume, em 720p | seedance-2.5-flash | 41 vs 63 créditos por segundo |
| Geração para o utilizador final em que o tempo de espera importa | seedance-2.5-flash | A afirmação de velocidade da ByteDance; os tempos do PoYo acima |
| Entrega em 1080p | seedance-2.5 | O Flash não tem 1080p |
| Mais de 10 imagens, 5 vídeos ou 5 referências de áudio | seedance-2.5 | Limites de referências mais altos |
| Renderização final de um rascunho Flash aprovado | seedance-2.5 | Modelo topo de gama, mesmo corpo de pedido |
| Storyboards e animatics | Flash, depois seedance-2.5 para os planos principais | Itera de forma barata, termina no topo de gama |
Encaminhar entre os dois IDs de modelo no código
Este router mantém um único construtor de pedidos para ambos. Só envia um pedido para o modelo standard quando o Flash não o consegue aceitar ou quando a tua política o marca como renderização final:
FLASH_LIMITS = {
"reference_image_urls": 10,
"reference_video_urls": 5,
"reference_audio_urls": 5,
}
def pick_model_id(input_body, final_render=False):
if input_body.get("resolution") == "1080p":
return "seedance-2.5"
for field, limit in FLASH_LIMITS.items():
if len(input_body.get(field) or []) > limit:
return "seedance-2.5"
if final_render:
return "seedance-2.5"
return "seedance-2.5-flash"
def build_request(input_body, final_render=False, callback_url=None):
body = dict(input_body)
body.setdefault("resolution", "720p") # required on seedance-2.5
request = {"model": pick_model_id(body, final_render), "input": body}
if callback_url:
request["callback_url"] = callback_url
return request
Submete o dict devolvido a /api/generate/submit como no guia da Seedance 2.5 Flash API, que também cobre a consulta de estado, os callbacks e os erros.
Diff de migração: promover um rascunho Flash a 1080p
Passar um rascunho aprovado para o modelo standard muda duas linhas:
{
- "model": "seedance-2.5-flash",
+ "model": "seedance-2.5",
"input": {
"prompt": "A paper boat drifts under a stone bridge at sunrise. Slow tracking shot.",
"duration": 10,
- "resolution": "480p",
+ "resolution": "1080p",
"aspect_ratio": "16:9"
}
}
Mantém inalterados o prompt, a duração, a proporção e os URLs de multimédia para que a renderização final siga o mesmo briefing. O custo dessa renderização passa de 185 créditos ($0.925) no Flash em 480p para 1140 créditos ($5.70) no standard em 1080p. Uma nova geração não é um upscale exato, frame a frame, do rascunho, por isso conta com diferenças. Para saberes como o Seedance 2.5 se compara com as APIs de vídeo de outros fornecedores, vê Kling 4.0 vs Seedance 2.5 e MiniMax H3 vs Seedance 2.5, e a página do modelo Seedance 2.5 para o respetivo playground.
Perguntas frequentes
Qual é a diferença entre a Seedance 2.5 Flash API e a Seedance 2.5 API? Os mesmos campos e o mesmo endpoint. O Flash gera em 480p ou 720p com até 10 / 5 / 5 referências de imagem, vídeo e áudio, e custa cerca de um terço menos por segundo. O standard acrescenta 1080p e até 30 / 10 / 10 referências.
Posso passar do Seedance 2.5 Flash para o Seedance 2.5 mudando apenas o ID do modelo? Sim, desde que o pedido inclua resolution, que é obrigatório no seedance-2.5, e se mantenha dentro dos seus limites.
A Seedance 2.5 Flash API é mais rápida do que o Seedance 2.5? A ByteDance diz que gera com quase o dobro da velocidade. O PoYo mediu cerca de 2 minutos para 4 s em 480p e menos de 3 minutos para 30 s em 720p no Flash; não temos tempos equivalentes para o modelo standard.
Que modelo da Seedance 2.5 API suporta 1080p? Apenas o seedance-2.5, a 114 créditos ($0.57) por segundo.
Quantos ficheiros de referência aceita a Seedance 2.5 Flash API? Até 10 imagens, 5 vídeos e 5 clips de áudio por pedido, com os vídeos de referência e o áudio de referência limitados, cada um, a no máximo 30 segundos combinados.