Com o FlowModels, você gera vídeos curtos a partir de uma descrição em texto ou de uma imagem inicial. Um vídeo é criado em segundo plano: você inicia uma tarefa, nós reservamos o valor e, assim que o vídeo fica pronto, você pode reproduzi-lo ou baixá-lo. Isso funciona no Playground do dashboard ou diretamente pela API.
Os modelos
| Modelo | Entrada | Duração | Resolução | Som |
|---|---|---|---|---|
bytedance/seedance-2.5/text-to-video |
prompt | 4 a 30 segundos | 480p, 720p, 1080p |
sim |
bytedance/seedance-2.5/image-to-video |
imagem inicial, prompt opcional | 4 a 30 segundos | 480p, 720p, 1080p |
sim |
minimax/h3/text-to-video |
prompt | 5 a 15 segundos | 2K |
não |
minimax/h3/image-to-video |
imagem inicial e prompt | 5 a 15 segundos | 2K |
não |
alibaba/wan-3.0/text-to-video |
prompt | 2 a 30 segundos | 480p, 720p, 1080p |
sim |
alibaba/wan-3.0/image-to-video |
imagem inicial e prompt | 2 a 30 segundos | 480p, 720p, 1080p |
sim |
Todos os modelos de imagem para vídeo aceitam também uma imagem final. Use apenas modelos que aparecem com o tipo video na sua resposta de GET /v1/models. Lá, video traz os valores permitidos por modelo e pricing.variants traz os preços por segundo. Não há troca automática para outro modelo.
No Playground
No dashboard, abra o Playground e a aba Vídeos. Escolha o Modelo, descreva a cena no campo Prompt e defina Duração em segundos e Resolução. Conforme o modelo, aparecem também Proporção, Formato de saída, Gerar som, Modo de raciocínio, Adicionar marca de água de IA ou Seed (opcional). Em imagem para vídeo, você envia uma Imagem inicial e, se quiser, uma Imagem final (JPEG, PNG, WebP ou GIF, até 10 MB).
Antes de iniciar, Reserva mostra o valor separado para a sua seleção e o preço por segundo. Com Gerar vídeo, você inicia a tarefa.

Em Os seus vídeos aparecem todos os vídeos da sua equipe, inclusive os iniciados pela API. Enquanto um vídeo está em andamento, a lista se atualiza sozinha. Vídeos prontos podem ser reproduzidos ali mesmo ou baixados, um vídeo que ainda está na fila pode ser cancelado e um vídeo encerrado pode ser excluído. A lista não mostra prompts, porque toda a equipe pode vê-la. A cobrança é feita no crédito FlowModels da sua equipe, por isso você não precisa de uma chave de API. Em Consumo e Solicitações, as suas chamadas aparecem como "Playground · seu nome".
O que as outras abas do Playground fazem e quais limites valem nelas está em Experimentar modelos no Playground.
Pela API
Envie a tarefa para POST /v1/videos:
curl https://api.flowmodels.one/v1/videos \
-H "Authorization: Bearer at_sua_chave" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: video-campanha-verao-01" \
-d '{"model": "bytedance/seedance-2.5/text-to-video", "prompt": "Um barquinho de papel em um lago calmo ao nascer do sol", "duration": 5, "resolution": "720p"}'
A API responde na hora com HTTP 202 e uma tarefa com id e status queued. Com o mesmo Idempotency-Key, você pode repetir a requisição com segurança depois de um erro de rede, sem que um segundo vídeo seja criado.
Os campos mais importantes:
modeleprompt: o prompt é obrigatório em todos os modelos de texto para vídeo e, em imagem para vídeo, no MiniMax e no Wan, com até 7.000 caracteres.image_urlouimage_file_id: a imagem inicial como endereçohttps, como URLdata:ou como ID de um arquivo dePOST /v1/files. Para a imagem final, existemend_image_urleend_image_file_id.duration,resolution,aspect_ratio: duração em segundos (padrão 5), resolução e proporção dentro dos limites do modelo. No Seedance de imagem para vídeo, a proporção segue a da imagem.generate_audio(Seedance e Wan),output_formatcommp4oumov(apenas Seedance de texto para vídeo),enable_thinkingeseed(apenas Wan),aigc_watermark(apenas MiniMax).
Se o modelo não conhece um campo, a API o recusa com 422 e o nome do campo em param, antes de qualquer reserva.
Status e consulta
- Consulte a tarefa com
GET /v1/videos/{id}, no máximo a cada cinco segundos. Como alternativa, um webhook informa os eventosvideo.completed,video.failedevideo.cancelled, veja Configurar webhooks do FlowModels. statusfica primeiro emqueued, depois emin_progresse, no fim, emcompleted,failedoucancelled.- Quando o vídeo fica pronto, a resposta traz
content_url,content_typeesize_bytes.GET /v1/videos/{id}/contentresponde com 302 para um endereço de download válido por 15 minutos.
GET /v1/videos lista as tarefas da sua equipe, e com limit, after e status você pagina e filtra.
Com POST /v1/videos/{id}/cancel, você cancela uma tarefa enquanto a geração ainda não começou, e a reserva é liberada. Se ela já estiver em andamento, a API responde com 409 video_not_cancellable, e o vídeo é concluído e cobrado.
Retenção
Um vídeo pronto fica disponível por sete dias a partir da conclusão, e expires_at indica o momento exato. Depois disso, excluímos o vídeo e a tarefa automaticamente. Com DELETE /v1/videos/{id} ou no Playground, você exclui um vídeo encerrado antes.
Quanto custa um vídeo
Os vídeos são cobrados por segundo. O preço depende do modelo, da resolução, do som e, no Wan, do modo de raciocínio. O preço atual aparece em Modelos e em GET /v1/models, em pricing.variants.
No início, fixamos o preço e reservamos a duração total solicitada. O valor só é debitado quando o vídeo pronto está armazenado conosco. Tarefas com falha, recusadas e canceladas não custam nada. O valor cobrado aparece na tarefa concluída em usage.cost.
Limites
- Quantos vídeos sua equipe pode gerar ao mesmo tempo depende do seu nível de limite de requisições: 3, 5, 10 ou 20. Veja Limite de requisições: como funcionam os níveis.
- Imagens iniciais e finais podem ter até 10 MiB.
- Os vídeos gerados são criados por IA. Identifique-os como tal ao publicá-los.
Quando algo não funciona
422 invalid_video_request: um campo não combina com o modelo, eparamindica qual.422 video_input_invalid: a imagem está faltando, é inválida, grande demais ou não pertence à sua equipe.429 insufficient_quotaou429 spend_limit_exceeded: o saldo ou o limite de gastos não é suficiente para a reserva.429 video_concurrency_exceeded: já há vídeos demais em andamento. Aguarde o tempo indicado emRetry-After.503 video_model_unavailable,503 video_pricing_unavailableou503 video_provider_unavailable: tente de novo mais tarde, seu saldo não foi debitado.404 video_not_found: o ID é desconhecido ou não pertence à sua equipe.409 video_not_readyou409 video_not_deletable: o status atual ainda não permite a ação.- Tarefa
failed:error.codeindica o motivo, por exemplovideo_generation_failedouvideo_content_rejected. Em casos raros, comovideo_submit_uncertain, o valor continua reservado até verificarmos o caso.