Uma descrição vira um vídeo.
Você envia um prompt ou uma imagem inicial para POST /v1/videos. O clipe é criado em segundo plano, e você consulta o status ou recebe um aviso por webhook.
Estes modelos estão disponíveis.
A tabela lê o mesmo catálogo da página de preços. Preços em euros por segundo, a partir da resolução mais barata. Modelos com imagem inicial precisam de uma imagem como entrada.
| Modelo | Início | Duração | Resolução | Som | A partir de€ por segundo |
|---|---|---|---|---|---|
alibaba/wan-3.0/image-to-video
Alibaba
|
Imagem inicial | 2 a 30 s | 480p, 720p, 1080p | sim | 0,0427 |
alibaba/wan-3.0/text-to-video
Alibaba
|
Texto | 2 a 30 s | 480p, 720p, 1080p | sim | 0,0427 |
bytedance/seedance-2.5/image-to-video
ByteDance
|
Imagem inicial | 4 a 30 s | 480p, 720p, 1080p | sim | 0,1341 |
bytedance/seedance-2.5/text-to-video
ByteDance
|
Texto | 4 a 30 s | 480p, 720p, 1080p | sim | 0,1341 |
minimax/h3/image-to-video
MiniMax
|
Imagem inicial | 5 a 15 s | 2K | não | 0,1481 |
minimax/h3/text-to-video
MiniMax
|
Texto | 5 a 15 s | 2K | não | 0,1481 |
Você paga quando o vídeo fica pronto.
Ao criar a tarefa, o FlowModels reserva o valor da duração escolhida. A cobrança só acontece depois da entrega, por segundo da duração escolhida. Se você cancelar a tarefa antes de a geração começar, a reserva é liberada.
- Imagem inicial
- Como
image_url(https ou data URL) ou comoimage_file_id, até 10 MiB. Alguns modelos aceitam também uma imagem final. - Download
GET /v1/videos/{id}/contentredireciona para um link de download válido por 15 minutos.- Retenção
- Vídeos prontos ficam disponíveis por 7 dias, depois o FlowModels os exclui. Com
DELETE /v1/videos/{id}você exclui antes. - Simultâneas
- Conforme o nível, de 3 a 20 tarefas em execução por equipe.
Uma tarefa em segundo plano.
A resposta chega na hora com 202 e o ID da tarefa. Com GET /v1/videos/{id} você consulta o status, e GET /v1/videos lista todas as tarefas.
curl https://api.flowmodels.one/v1/videos \
-H "Authorization: Bearer $FLOWMODELS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "alibaba/wan-3.0/text-to-video",
"prompt": "Um barco de papel em um lago calmo ao nascer do sol",
"duration": 5
}'
{
"id": "018f9abc-1234-7abc-9def-0123456789ab",
"object": "video",
"model": "alibaba/wan-3.0/text-to-video",
"status": "queued",
"seconds": 5,
"content_url": null,
"error": null,
"created_at": "2026-11-13T10:00:00+01:00",
"expires_at": null,
"flowai_request_id": "01HXYZ8M3F6V2KQ"
}
Status de uma tarefa
queuedin_progresscompletedfailedcancelled
Cancelar e excluir
POST /v1/videos/{id}/cancel cancela uma tarefa enquanto a geração ainda não começou. Depois disso, a API responde com 409 video_not_cancellable, e o vídeo é concluído. DELETE /v1/videos/{id} remove um vídeo concluído antes do fim do prazo.
Webhooks
Com um webhook configurado, o FlowModels avisa video.completed, video.failed e video.cancelled.
Teste primeiro no painel.
Em Vídeos você escolhe modelo, duração e resolução, vê o preço por segundo antes de começar e baixa os clipes prontos. A cobrança passa pela chave de API escolhida.