¿Cómo usar la API de video FLUX.3? Tutorial en chino de texto a video, imagen a video y continuación de video

TL;DR

• FLUX.3 Video es el modelo de video de Black Forest Labs; en HiAPI solo tiene un nombre de modelo, flux-3, y admite a la vez texto a video, imagen a video (1–10 fotogramas clave) y continuación de video, con clips de 5–20 segundos y audio sincronizado por defecto. Abre la página del modelo para generar en línea; los usuarios nuevos reciben 200 créditos al registrarse.
• Facturación por segundo: 720p $0.25 por segundo, 1080p $0.42 por segundo; el modo de vista previa Draft cuesta solo $0.09 por segundo. Una vista previa Draft de 5 segundos cuesta $0.45.
• Al ajustar el prompt, activa siempre draft: true primero: solo prompt es obligatorio, y si no pones otros parámetros también se cobrará a la tarifa estándar.

Primero mira el resultado

Ejemplo de la página del modelo, 720p, 5 segundos, con audio:

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

Generar con este prompt → (5 segundos, 720p)

Ejemplo de la página del modelo flux-3, 720p, 5 segundos, con audio. A tarifa estándar cuesta $1.25; con la vista previa Draft, $0.45.

Precios

Modo	720p / segundo	1080p / segundo
Generación estándar (texto a video, imagen a video)	$0.25	$0.42
Vista previa Draft	$0.09	No disponible
Continuación de video (enviar start_video)	$0.59	$0.76
Draft + continuación de video	$0.18	No disponible

Precio actual de HiAPI, verificado el 15 de octubre de 2026. Activar o desactivar el audio no afecta el precio.

Duración	Draft 720p	Estándar 720p	Estándar 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

Flujo recomendado: ajusta el prompt y el movimiento con Draft (desde $0.45 por clip) y, cuando esté definido, genera en 720p o 1080p con la tarifa estándar.

curl: primero ejecuta un 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. Después de recibir taskId, consulta el resultado:

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

Cuando status sea success, descarga el video desde output[0].url; el audio ya viene integrado en el mismo MP4.

Python: enviar, consultar y descargar

# 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 clip de 8 segundos en 1080p cuesta $3.36.

Imagen a video: 1 primer fotograma o hasta 10 fotogramas clave

Añade images dentro de input (no image_urls); el uso depende del número de imágenes:

• 1 imagen: primer fotograma.
• 2 imágenes: primer fotograma + último fotograma; el modelo rellena la transición intermedia.
• 3–10 imágenes: storyboard de fotogramas clave, distribuidos uniformemente a lo largo de todo el video.

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

Las imágenes admiten PNG, JPEG y WebP. Imagen a video cuesta lo mismo que texto a video.

Continuación de video: sigue grabando a partir de un video existente

Envía start_video y el modelo seguirá generando desde el final de ese video:

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

• start_video solo admite MP4, con una duración máxima de 15 segundos y un tamaño máximo de 50 MB.
• images y start_video no se pueden enviar al mismo tiempo.
• La continuación tiene un precio unitario más alto: 720p $0.59 por segundo, Draft de continuación $0.18 por segundo.

Resumen de parámetros

Parámetro	Valores	Descripción
prompt	Cadena, obligatorio	Escena, acción, movimiento de cámara, diálogo y audio se escriben aquí
duration	Entero de 5–20, por defecto 5	Unidad en segundos
resolution	720p / 1080p, por defecto 720p	Draft solo admite 720p; Draft con 1080p se rechaza
aspect_ratio	auto 21:9 2:1 16:9 4:3 1:1 3:4 9:16, por defecto auto
draft	Por defecto false	Modo de vista previa a bajo precio
generate_audio	Por defecto true	Al desactivarlo se genera video sin audio; el precio no cambia
images	Hasta 10 imágenes	Imagen a video
start_video	Dirección MP4	Continuación de video

Antes de salir a producción

• Usa callback en lugar de polling: añade en el nivel superior de la solicitud (al mismo nivel que input) "callback": {"url": "https://tu-dominio/hiapi/callback"} y deduplica por taskId.
• Guarda el resultado a tiempo: output[0].url es un enlace temporal; en cuanto lo recibas, guárdalo en tu propio almacenamiento.
• Reintentos con clave de idempotencia: añade Idempotency-Key en la cabecera; reintentar con la misma clave crea la tarea una sola vez y no cobra dos veces.
• Reembolso automático en caso de fallo: solo se cobran los videos generados correctamente.

Preguntas frecuentes

¿Cuánto dura como máximo un clip?

20 segundos. Si necesitas más, usa la continuación de video para seguir generando.

¿Se puede desactivar el audio? ¿Es más barato sin él?

Sí, con generate_audio: false. El precio solo depende de la resolución, de Draft y de si es continuación; desactivar el audio no lo abarata.

¿Cuánta diferencia hay entre Draft y la tarifa estándar?

En 720p, $0.09 por segundo frente a $0.25; Draft es aproximadamente un 64% más barato y genera más rápido, ideal para ajustar prompts.

¿Por qué el nombre del modelo no tiene el sufijo /text-to-video?

FLUX.3 combina texto a video, imagen a video y continuación en un único flux-3, y distingue el uso según si se envían o no images y start_video.

Si quieres probar uno primero, ve a la página del modelo para generar. Para comparar más precios de modelos de video, consulta la página de precios.