
A Seedance 2.5 API na PoYo tem dois IDs de modelo: seedance-2.5-flash para a Seedance 2.5 Flash API, lançada pela ByteDance em 12 de novembro de 2026, e seedance-2.5 para o modelo padrão. Eles compartilham um endpoint e um formato de requisição, então a escolha é uma decisão de roteamento por requisição: resolução, número de referências, custo e a rapidez com que o resultado é necessário. Esta comparação foi conferida nas duas páginas de documentação em 16 de novembro de 2026.
Mesma requisição da Seedance 2.5 API, dois IDs de modelo
Os dois modelos são enviados para POST https://api.poyo.ai/api/generate/submit e lidos de volta por GET /api/generate/status/{task_id} ou por 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 (padrã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, padrão true | Booleano |
image_urls | Primeiro quadro + último quadro opcional; aspect_ratio auto | Igual |
reference_image_urls | Até 10 | Até 30 |
reference_video_urls | Até 5 | Até 10 |
reference_audio_urls | Até 5, exige uma imagem ou vídeo de referência | Até 10, exige uma imagem ou vídeo de referência |
Nos dois, image_urls não pode ser combinado com os campos de referência, as referências são citadas no prompt como @Image1, @Video1, @Audio1, e todas as URLs de mídia precisam ser públicas e com download direto. A única armadilha no schema: resolution é opcional no Flash, mas obrigatório no seedance-2.5. Se o seu cliente depende do padrão de 720p do Flash, adicione resolution explicitamente antes de encaminhar uma requisição ao modelo padrão.
Limites que diferem
| Limite | Flash | Padrão |
|---|---|---|
| Resolução de saída | 480p, 720p | 480p, 720p, 1080p |
| Duração por geração | 4–30 s | 4–30 s |
| Imagens / vídeos / áudios de referência | 10 / 5 / 5 | 30 / 10 / 10 (máximo de 50 arquivos) |
| Velocidade de geração | Quase duas vezes mais rápido, segundo a ByteDance | Referência |
A documentação do Flash também publica regras por arquivo: imagens JPEG, PNG ou WebP de até 30 MB; vídeos de referência MP4 ou MOV, de 2–30 s e até 200 MB cada, com no máximo 30 s somados; áudio de referência MP3 ou WAV, de 2–30 s e até 15 MB cada, com no máximo 30 s somados. A página da documentação do Seedance 2.5 não lista tamanhos por arquivo, então não presuma um limite de arquivo maior no modelo padrão.
Preço por requisição idêntica
Mesmo corpo, mudando só o ID do modelo. 1 crédito = US$ 0,005; o áudio gerado é gratuito nos dois.
| Requisição | seedance-2.5-flash | seedance-2.5 | Economia do 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, os dois modelos cobram os segundos de saída mais a duração de cada vídeo de referência arredondada para baixo, pela tarifa menor com vídeo (Flash 11,5 / 25,5 créditos; padrão 17 / 38 / 68,5 créditos em 480p / 720p / 1080p). O post de 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 pela PoYo
A ByteDance descreve o Seedance 2.5 Flash como capaz de entregar resultados próximos aos do Seedance 2.5 principal 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 em uma página que conseguíssemos ler.
O que a PoYo mediu em 16 de novembro de 2026, de ponta a ponta pela API, no seedance-2.5-flash:
| Requisição | Tempo até concluir |
|---|---|
| 4 s, 480p | Cerca de 2 minutos |
| 30 s, 720p | Menos de 3 minutos |
Não fizemos um teste de tempo equivalente no seedance-2.5, então este post não apresenta um ganho de velocidade medido. Os tempos variam com a carga. Em qualquer caso, projete para o modo assíncrono: a documentação de status indica uma geração de vídeo típica de 90–300 segundos, tempo demais para manter uma requisição HTTP síncrona aberta.
Qual ID de modelo chamar, por caso de uso
| Caso de uso | ID do modelo | Motivo |
|---|---|---|
| Teste de prompts, variações A/B | seedance-2.5-flash em 480p | 18.5 créditos por segundo, a menor tarifa do Seedance 2.5 |
| Clipes para redes sociais em grande volume em 720p | seedance-2.5-flash | 41 contra 63 créditos por segundo |
| Geração voltada ao usuário em que o tempo de espera importa | seedance-2.5-flash | Afirmação de velocidade da ByteDance; tempos da PoYo acima |
| Entrega em 1080p | seedance-2.5 | O Flash não tem 1080p |
| Mais de 10 imagens, 5 vídeos ou 5 áudios de referência | seedance-2.5 | Limites de referência maiores |
| Renderização final de um rascunho aprovado no Flash | seedance-2.5 | Modelo principal, mesmo corpo de requisição |
| Storyboards e animatics | Flash, depois seedance-2.5 para os planos principais | Itere barato, finalize no modelo principal |
Roteie entre os dois IDs de modelo no código
Este roteador mantém um único construtor de requisição para os dois. Ele só envia uma requisição ao modelo padrão quando o Flash não consegue recebê-la ou quando a sua política a 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
Envie o dict retornado para /api/generate/submit como no guia da Seedance 2.5 Flash API, que também cobre polling, callbacks e erros.
Diff de migração: promova um rascunho do Flash para 1080p
Mover um rascunho aprovado para o modelo padrão 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"
}
}
Mantenha o prompt, a duração, a proporção e as URLs de mídia inalterados para que a renderização final siga o mesmo briefing. O custo dessa renderização vai de 185 créditos (US$ 0,925) no Flash em 480p para 1.140 créditos (US$ 5,70) no padrão em 1080p. Uma nova geração não é um upscale quadro a quadro do rascunho, então espere diferenças. Para ver como o Seedance 2.5 se compara com as APIs de vídeo de outros fornecedores, veja 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 playground.
Perguntas frequentes
Qual é a diferença entre a Seedance 2.5 Flash API e a Seedance 2.5 API? Mesmos campos e 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 a menos por segundo. O padrão acrescenta 1080p e até 30 / 10 / 10 referências.
Posso mudar do Seedance 2.5 Flash para o Seedance 2.5 trocando apenas o ID do modelo? Sim, desde que a requisição inclua resolution, que é obrigatório no seedance-2.5, e fique dentro dos limites dele.
A Seedance 2.5 Flash API é mais rápida que o Seedance 2.5? A ByteDance diz que ela gera com quase o dobro da velocidade. A 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 um tempo equivalente para o modelo padrão.
Qual modelo da Seedance 2.5 API suporta 1080p? Apenas o seedance-2.5, a 114 créditos (US$ 0,57) por segundo.
Quantos arquivos de referência a Seedance 2.5 Flash API aceita? Até 10 imagens, 5 vídeos e 5 clipes de áudio por requisição, com vídeos de referência e áudios de referência limitados a 30 segundos somados cada.