Video
Seedance 2.5 Flash
Gere vídeos de 4–30 segundos em 480p ou 720p a partir de texto, quadros inicial/final ou referências multimodais, ou edite um vídeo de origem.
Seedance 2.5 Flash oferece geração de texto para vídeo, geração com quadros inicial/final, geração com referências e edição de vídeo. Use dreamina-seedance-2-5-flash com o nível Default. Envie mídias como URLs públicas HTTP ou HTTPS sem credenciais. Salve o ID da tarefa retornado e consulte-o para obter o vídeo concluído.
Consulte o playground e os preços em tempo real, a especificação OpenAPI e o guia de preços.
Exemplo rápido
Esta solicitação cria um vídeo de quatro segundos. Confira o preço atual antes de enviá-la; uma geração enviada e concluída com sucesso gera uma cobrança.
curl https://api.seedrouter.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "dreamina-seedance-2-5-flash",
"content": [{"type": "text", "text": "A ceramic cup slowly rotates under warm studio lighting."}],
"resolution": "480p",
"duration": 4,
"ratio": "16:9",
"generate_audio": false
}'Parâmetros
model e content são obrigatórios. Todos os outros campos são opcionais. Valores null explícitos e campos desconhecidos são rejeitados.
| Campo | Tipo | Padrão | Restrições |
|---|---|---|---|
model | texto | obrigatório | dreamina-seedance-2-5-flash |
content | lista | obrigatório | Pelo menos um item de texto não vazio; itens de mídia exigem uma função. |
resolution | texto | 720p | 480p ou 720p. |
duration | inteiro | 5, ou -1 para edição | Geração: 4–30 segundos. Edição: omita ou use -1; a saída segue a origem. |
ratio | texto | 16:9, ou adaptive para quadros/edição | Geração com texto/referências: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9. Quadros inicial/final e edição: somente adaptive. |
generate_audio | booleano | true | Ative ou desative o áudio gerado; isso não altera a tarifa. |
omni_reference_task_type | texto | generate | generate ou edit. A edição exige exatamente um vídeo. |
content_filter | booleano | true | Apenas true é aceito; nenhum controle é necessário no playground. |
Os prompts têm um limite documentado de 10.000 tokens. Nenhum tokenizador público é especificado, portanto a contagem de caracteres não deve ser tratada como uma contagem exata de tokens.
Conteúdo e modos
O texto usa {"type":"text","text":"Describe the shot"}. Imagens, vídeos e áudios usam uma URL aninhada e uma função explícita:
{
"type": "image_url",
"image_url": {"url": "https://example.com/reference.jpg"},
"role": "reference_image"
}| Modo | Conteúdo | Enquadramento e duração |
|---|---|---|
| Texto para vídeo | Somente texto | Proporção fixa; 4–30 segundos. |
| Quadros inicial/final | Texto mais uma imagem first_frame e, opcionalmente, uma imagem last_frame | adaptive; 4–30 segundos. O quadro final exige o quadro inicial. |
| Geração com referências | Texto mais itens reference_image, reference_video ou reference_audio | Proporção fixa; 4–30 segundos. Até 10 imagens, 5 vídeos e 5 áudios. |
| Edição de vídeo | Texto, exatamente um reference_video, imagens/áudios de referência opcionais; tipo de tarefa edit | adaptive; duração omitida ou -1. |
Os itens de vídeo usam type: "video_url", video_url: {"url": "..."}, role: "reference_video"; os itens de áudio usam audio_url e reference_audio na mesma estrutura. Quadros inicial/final não podem ser combinados com mídias de referência. Os controles de Draft, Extend, 1080p, marca-d’água, semente e saída do quadro final não estão disponíveis nesta integração. Callbacks não são oferecidos.
Restrições de mídia
| Mídia | Formatos | Tamanho e duração |
|---|---|---|
| Imagem | JPEG, PNG, WebP | Até 30 MB; cada lado de 300–6.000 px; proporção largura/altura de 0,4–2,5. |
| Vídeo | MP4, MOV | Até 200 MB; 24–60 FPS; cada lado de 300–6.000 px; proporção de 0,4–2,5; 409.600–8.295.044 pixels. Referências: 2–30 segundos cada, no máximo 30 segundos no total. Origem da edição: 4–30 segundos. |
| Áudio | WAV, MP3 | Até 15 MB; 2–30 segundos cada, no máximo 30 segundos no total. |
Os arquivos devem estar acessíveis para leitura antes do envio. A duração do vídeo é medida a partir da mídia para calcular a cobrança. Use URLs públicas estáveis.
Resposta da tarefa e consulta periódica
A criação retorna id, model, status e created_at. Consulte a mesma tarefa até que ela seja concluída:
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"O status é processing, completed ou failed. Em caso de sucesso, leia output.video_url para obter o vídeo armazenado. Em caso de falha, leia error.code e error.message. As respostas públicas não incluem custos. Um tempo limite na consulta periódica não comprova que a geração falhou: guarde o ID da tarefa e consulte-a novamente em vez de enviar outra geração.
Cobrança
A tarifa em tempo real depende da resolução e de haver ou não um vídeo fornecido. Sem vídeo de entrada, os segundos cobrados equivalem à duração da saída. Com vídeos de referência, os segundos cobrados equivalem à duração da saída mais o maior valor entre a duração da saída e a duração total das entradas arredondada para cima. Na edição, cobra-se o dobro da duração da origem arredondada para cima. O áudio está incluído. Solicitações que falham não são cobradas.
Por exemplo, uma saída de cinco segundos com três segundos de vídeo de referência cobra dez segundos. A edição de uma origem de dez segundos cobra vinte segundos. Multiplique os segundos cobrados pela tarifa em tempo real aplicável.
Consulte o ciclo de vida das tarefas e os códigos de erro para ver respostas comuns e orientações sobre novas tentativas.
