Como usar a API de vídeo FLUX.3? Tutorial em chinês de texto para vídeo, imagem para vídeo e continuação de vídeo

TL;DR

• FLUX.3 Video é o modelo de vídeo da Black Forest Labs, e na HiAPI tem apenas um nome de modelo, flux-3, que suporta ao mesmo tempo texto para vídeo, imagem para vídeo (1–10 quadros-chave) e continuação de vídeo, com cada clipe de 5–20 segundos e áudio sincronizado por padrão. Abra a página do modelo para gerar online; novos usuários ganham 200 créditos ao se registrar.
• Cobrança por segundo: 720p a $0.25 por segundo, 1080p a $0.42 por segundo; o modo de prévia Draft custa apenas $0.09 por segundo. Uma prévia Draft de 5 segundos custa $0.45.
• Ao ajustar o prompt, sempre ative primeiro draft: true: apenas prompt é obrigatório, e sem preencher os outros parâmetros a cobrança também será feita na faixa normal.

Veja o resultado primeiro

Exemplo da página do modelo, 720p, 5 segundos, com áudio:

A silent maglev train glides through a vast solar-panel field at golden hour, reflective silver body catching warm directional light, low tracking shot alongside the train, distant maintenance drones crossing the sky, cinematic composition, rich cohesive color grade, premium commercial finish, subtle film grain, high dynamic range, smooth natural motion, stable cinematic camera movement, consistent lighting across frames

Gerar com este prompt → (5 segundos, 720p)

Exemplo da página do modelo flux-3, 720p, 5 segundos, com áudio. Na faixa normal custa $1.25; com prévia Draft, $0.45.

Preços

Modo	720p / segundo	1080p / segundo
Geração normal (texto para vídeo, imagem para vídeo)	$0.25	$0.42
Prévia Draft	$0.09	Não suportado
Continuação de vídeo (enviar start_video)	$0.59	$0.76
Draft + continuação de vídeo	$0.18	Não suportado

Preço atual da HiAPI, verificado em 15 de outubro de 2026. Ativar ou não o áudio não afeta o preço.

Duração	Draft 720p	Normal 720p	Normal 1080p
5 segundos	$0.45	$1.25	$2.10
10 segundos	$0.90	$2.50	$4.20
20 segundos	$1.80	$5.00	$8.40

Fluxo recomendado: usar o Draft para ajustar o prompt e a ação (a partir de $0.45 por clipe) e, após a versão final, gerar em 720p ou 1080p na faixa normal.

curl: primeiro execute um Draft

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-3",
    "input": {
      "prompt": "一架纸飞机滑过洒满阳光的办公室，慢动作，镜头跟随",
      "duration": 5,
      "aspect_ratio": "16:9",
      "draft": true
    }
  }'

Draft de 5 segundos, $0.45. Após receber o taskId, consulte o resultado:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Quando status for success, baixe o vídeo em output[0].url; o áudio já está incorporado no mesmo MP4.

Python: enviar, consultar e baixar

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(timeout_s=900, **params):
    body = {"model": "flux-3", "input": params}
    # 重试提交同一个任务时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

# 定稿后出正式 1080p
url = generate(
    prompt="一架纸飞机滑过洒满阳光的办公室，慢动作，镜头跟随",
    duration=8, resolution="1080p", aspect_ratio="16:9",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Este clipe de 8 segundos em 1080p custa $3.36.

Imagem para vídeo: 1 quadro inicial ou até 10 quadros-chave

Adicione images (não image_urls) dentro de input; a quantidade de imagens define o uso:

• 1 imagem: quadro inicial.
• 2 imagens: quadro inicial + quadro final; o modelo preenche a transição intermediária.
• 3–10 imagens: storyboard de quadros-chave, distribuídos uniformemente ao longo de todo o vídeo.

{
  "model": "flux-3",
  "input": {
    "prompt": "从日出平滑过渡到霓虹闪烁的夜晚城市，镜头稳定",
    "images": [
      "https://your-cdn.example.com/start.webp",
      "https://your-cdn.example.com/end.webp"
    ],
    "resolution": "1080p",
    "duration": 8
  }
}

As imagens suportam PNG, JPEG e WebP. Imagem para vídeo tem o mesmo preço que texto para vídeo.

Continuação de vídeo: continuar a partir de um vídeo existente

Envie start_video e o modelo continuará a geração a partir do final desse vídeo:

{
  "model": "flux-3",
  "input": {
    "prompt": "镜头继续向前推进，列车驶入明亮的山间隧道",
    "start_video": "https://your-cdn.example.com/source.mp4",
    "duration": 5,
    "draft": true
  }
}

• start_video só suporta MP4, com no máximo 15 segundos e 50 MB.
• images e start_video não podem ser enviados ao mesmo tempo.
• O preço unitário da continuação é maior: 720p a $0.59 por segundo; continuação Draft a $0.18 por segundo.

Visão geral dos parâmetros

Parâmetro	Valores	Descrição
prompt	String, obrigatório	Cena, ação, movimento de câmera, diálogo e áudio são escritos aqui
duration	Inteiro de 5–20, padrão 5	Unidade em segundos
resolution	720p / 1080p, padrão 720p	Draft só aceita 720p; Draft com 1080p será rejeitado
aspect_ratio	auto 21:9 2:1 16:9 4:3 1:1 3:4 9:16, padrão auto
draft	Padrão false	Faixa de prévia de baixo custo
generate_audio	Padrão true	Desativar gera vídeo sem áudio, sem alteração de preço
images	Até 10 imagens	Imagem para vídeo
start_video	Endereço MP4	Continuação de vídeo

Atenção antes de ir para produção

• Use callback em vez de polling: adicione no nível superior da requisição (no mesmo nível de input) "callback": {"url": "https://seu-dominio/hiapi/callback"} e deduplique por taskId.
• Salve imediatamente: output[0].url é um link temporário; assim que recebê-lo, salve no seu próprio armazenamento.
• Retentativas com chave de idempotência: adicione Idempotency-Key no cabeçalho da requisição; ao repetir com a mesma chave, a tarefa é criada apenas uma vez e não há cobrança duplicada.
• Reembolso automático em caso de falha: a cobrança é feita apenas sobre vídeos gerados com sucesso.

Perguntas frequentes

Qual é a duração máxima de um clipe?

20 segundos. Para mais, use a continuação de vídeo para seguir gerando.

É possível desativar o áudio? Fica mais barato?

Sim, com generate_audio: false. O preço depende apenas de resolução, Draft e se é continuação; desativar o áudio não deixa mais barato.

Qual é a diferença entre Draft e a faixa normal?

Em 720p, $0.09 por segundo contra $0.25; o Draft é cerca de 64% mais barato e também gera mais rápido, ideal para ajustar prompts.

Por que o nome do modelo não tem o sufixo /text-to-video?

O FLUX.3 reúne texto para vídeo, imagem para vídeo e continuação em um único flux-3, diferenciando pelo envio ou não de images e start_video.

Quer testar um primeiro clipe? vá à página do modelo para gerar. Para mais comparações de preços de modelos de vídeo, consulte a página de preços.