FLUX 3 Video
Geração de vídeo FLUX 3
- Modo de processamento assíncrono, retorna um ID de tarefa para consultas posteriores
- Entrada unificada: texto-para-vídeo / imagem-para-vídeo / continuação de vídeo / rascunho em duas etapas
- Saída H.264 + AAC com áudio sincronizado, duração 5~20 segundos
- Resolução hd / fhd, sete proporções
POST
Authorization
string
obrigatório
Todos os endpoints exigem autenticação por Bearer TokenObtenha sua chave de API na página de gerenciamento de chaves de API:
Modos de geração
flux-3-video é uma entrada unificada: o modo é inferido dos campos, ou definido explicitamente com mode.
Valores de
mode: t2v / i2v / v2v / draft_enhance, ou grafias oficiais text-to-video / image-continuation / video-continuation. mode explícito tem a maior prioridade.
Semântica de keyframes imagem-para-vídeo
A ordem emimage_urls é semântica — não ordene nem remova duplicatas:
Parâmetros da requisição
string
obrigatório
Valor fixo:
flux-3-videostring
obrigatório
Prompt. Não deve ser enviado ao usar
draft_from_task_id (rejeitado se presente).integer
padrão:"5"
Duração em segundos, inteiro 5~20, padrão
5Na continuação de vídeo, a duração entregue pode ser menor que a solicitada (ex. solicitar 5s, obter 4s). Os segundos solicitados são pré-cobrados e a diferença é reembolsada após a conclusão; o valor final é o
cost da consulta. Texto/imagem-para-vídeo não apresentam essa diferença.string
padrão:"hd"
Resolução
hd(padrão; também aceita720p)fhd(também aceita1080p)
hd ~1280×704 em 16:9; fhd ~1920×1088.string
padrão:"auto"
ProporçãoOpções:
21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16, ou auto (padrão; escolhido automaticamente com base no prompt e nos assets)string[]
Keyframes imagem-para-vídeo, 1~10, URL http(s) pública ou base64
string
Vídeo de entrada para continuação (mp4, URL pública ou base64)
string[]
Igual a
video_url; usa o primeiro item (compat)boolean
padrão:"true"
Gerar áudio sincronizado, padrão
true. false gera vídeo silencioso (sem desconto)boolean
padrão:"false"
Modo rascunho: prévia de baixa qualidade a ~1/3 do preço; apenas com
resolution: hdstring
Rascunho → final: ID da sua tarefa de rascunho bem-sucedida
- Apenas
resolutionpode mudar; prompt, duração, imagens, vídeo não podem - Cobrado a preço final cheio; a taxa do rascunho não é creditada
- Mutualmente exclusivo com
draft:true
integer
padrão:"2"
Tolerância de moderação 0~4, padrão
2 (maior = mais permissivo)Não confunda com imagens FLUX.2 (05) ou Kontext (06).
string
Modo explícito (opcional); veja Modos de geração
Modo rascunho
Fluxo em duas etapas quando iterar é caro:Criar rascunho
Rascunho para final
Exemplos de requisição
Texto-para-vídeo (retrato)
Imagem-para-vídeo (início + fim)
Continuação de vídeo
Vídeo silencioso
Restrições
Erros comuns de envio (geralmente não cobrados)
Falhas de moderação terminam como
failed com reembolso integral.
Cobertura de capacidades
Response
integer
Código de status; 200 em caso de sucesso
array
Array de dados da resposta
Consultar resultadosA geração de vídeo é assíncrona. Consulte Obter status da tarefa.Intervalo recomendado 5~10 segundos; timeout do cliente 15 minutos (20s fhd é mais lento). Medido ~60s para
t2v + hd + 5s.Em caso de sucesso, use result.videos[0].url; os assets são espelhados no CDN da plataforma. cost é a cobrança final. Falhas são totalmente reembolsadas.