Skip to main content
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 em image_urls é semântica — não ordene nem remova duplicatas:

Parâmetros da requisição

string
obrigatório
Valor fixo: flux-3-video
string
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 5
duration: "auto" não é suportado (a cobrança precisa de um número fixo de segundos). Omitido, "auto", ou não inteiros → tratados como 5 segundos sem erro e sem duração adaptativa.
Na 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 aceita 720p)
  • fhd (também aceita 1080p)
Medido: hd ~1280×704 em 16:9; fhd ~1920×1088.
O modo rascunho (draft:true) permite hd.
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: hd
string
Rascunho → final: ID da sua tarefa de rascunho bem-sucedida
  • Apenas resolution pode 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

A conversão rascunho → final re-renderiza em qualidade total com os parâmetros salvos do rascunho (mode / prompt / seed / assets). Rascunhos de continuação são finalizados às taxas finais de continuação.

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.