FlowModels

Gerar vídeos: Playground, API, modelos e custos

Publicado em 13. novembro 2026

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.

O Playground de vídeos com o formulário, a reserva e a lista de vídeos

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:

  • model e prompt: 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_url ou image_file_id: a imagem inicial como endereço https, como URL data: ou como ID de um arquivo de POST /v1/files. Para a imagem final, existem end_image_url e end_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_format com mp4 ou mov (apenas Seedance de texto para vídeo), enable_thinking e seed (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

  1. Consulte a tarefa com GET /v1/videos/{id}, no máximo a cada cinco segundos. Como alternativa, um webhook informa os eventos video.completed, video.failed e video.cancelled, veja Configurar webhooks do FlowModels.
  2. status fica primeiro em queued, depois em in_progress e, no fim, em completed, failed ou cancelled.
  3. Quando o vídeo fica pronto, a resposta traz content_url, content_type e size_bytes. GET /v1/videos/{id}/content responde 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, e param indica qual.
  • 422 video_input_invalid: a imagem está faltando, é inválida, grande demais ou não pertence à sua equipe.
  • 429 insufficient_quota ou 429 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 em Retry-After.
  • 503 video_model_unavailable, 503 video_pricing_unavailable ou 503 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_ready ou 409 video_not_deletable: o status atual ainda não permite a ação.
  • Tarefa failed: error.code indica o motivo, por exemplo video_generation_failed ou video_content_rejected. Em casos raros, como video_submit_uncertain, o valor continua reservado até verificarmos o caso.

Este artigo foi útil?

Voltar para Modelos, limites e erros