Black Forest Labs

FLUX 3 Max

flux-3-max/text-to-video

Modelo de generación de video que admite texto a video e imagen a video, enfocado en una baja latencia y una producción rápida; según sus benchmarks públicos, un clip de 10 segundos se genera en aproximadamente 11–12 segundos, ideal para la iteración creativa y el material de video corto

flux-3-max/image-to-video flux-3-max/keyframes-to-video flux-3-max/text-to-video

Probar flux-3-max/text-to-video

Entrada

Creaciones

Ver todas las creaciones

Salida

video

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

flux-3-max/text-to-video per second

Especificaciones	Precio unitario
720P	$0.0608
1080P	$0.1036

Descripción general

flux-3-max/text-to-video es la línea de generación de video orientada a entrada exclusivamente de texto dentro de la serie flux-3-max: los desarrolladores solo necesitan enviar un prompt para generar un clip de video con audio sincronizado, según la duración, la resolución y la relación de aspecto especificadas. Esta línea admite duraciones de 5 a 20 segundos, dos niveles de resolución (720p y 1080p) y ofrece ajuste de la intensidad de razonamiento, para equilibrar la fidelidad en escenas complejas y la latencia de generación. Es adecuada para creadores y equipos de producto que necesitan validar conceptos rápidamente, crear storyboards preliminares y videos cortos de marketing, invocándola a través de la interfaz unificada de HiAPI.ai sin necesidad de integrar múltiples protocolos upstream.

Aspectos destacados

Del prompt al video, sin entrada de material: basta con enviar un prompt de texto para completar la generación del video, ideal para la exploración creativa desde cero y la producción por lotes.
Amplio control de duración y relación de aspecto: la duración puede especificarse entre 5 y 20 segundos, y la relación de aspecto cubre ocho opciones desde 21:9 hasta 9:16, alineándose directamente con la proporción del canal de difusión.
Audio sincronizado nativo: por defecto se genera audio sincronizado junto con el video, eliminando los pasos de doblaje y sincronización posteriores.
Intensidad de razonamiento ajustable: reasoning_level ofrece dos niveles, low y high; high es más adecuado para escenas complejas y low se centra en reducir el tiempo de espera.

Capacidades

Generación de video directamente desde texto: un prompt de hasta 6000 caracteres es la única entrada obligatoria y devuelve un archivo de video completo, ideal para convertir rápidamente un guion de texto en material dinámico previsualizable.

Configuración de duración y resolución: cada generación permite especificar una duración de 5 a 20 segundos y elegir entre 720p y 1080p, lo que facilita ajustar la nitidez y el presupuesto de duración según la ubicación de difusión.

Salida en múltiples relaciones de aspecto: admite ocho relaciones —auto, 21:9, 2:1, 16:9, 4:3, 1:1, 3:4 y 9:16—, por lo que los videos cortos verticales y el material de pantalla ancha pueden realizarse dentro de la misma línea.

Generación de audio sincronizado: generate_audio está activado por defecto, de modo que al generar la imagen se produce también la pista de audio sincronizada, reduciendo los pasos de posprocesamiento del video final.

Cambio de intensidad de razonamiento del prompt: reasoning_level controla la profundidad de análisis del prompt; high puede usarse en escenas de planificación compleja y low cuando se busca mayor rendimiento.

Casos de uso

Validación de conceptos de guion para equipos creativos: generar directamente un video corto a partir de una idea textual para revisiones internas y selección de dirección, reduciendo el costo de ida y vuelta de crear primero el storyboard y luego renderizar.
Producción de videos cortos para marketing y redes sociales: generar por lotes material de video de productos y marcas en proporciones como 9:16 o 16:9, listo para entrar directamente en los flujos de difusión y edición.
Previsualización de storyboards y creación de borradores: generar clips de 5 a 20 segundos con prompts de descripción de nivel cinematográfico, como referencia de borrador dinámico antes de la producción formal.
Experimentación en video para creadores independientes: gracias a la intensidad de razonamiento ajustable y las múltiples opciones de relación de aspecto, probar distintos estilos visuales y ritmos a bajo costo.

Limitaciones y recomendaciones de selección

Esta línea solo acepta entrada de texto; cuando se requiera restringir la imagen con una imagen de referencia, deberá usarse la línea de imagen a video o de fotogramas clave de la misma serie. La información pública cubre principalmente la especificación de 720p y unos 10 segundos; si la descripción del prompt es demasiado compleja o se alarga la duración, se recomienda generar primero un lote pequeño para verificar si la imagen y el audio cumplen el estándar. Los datos de velocidad de generación de los benchmarks públicos provienen de entornos del lado del fabricante, y el tiempo real depende del prompt, la carga y las condiciones de despliegue. Para proyectos con altos requisitos de calidad de imagen determinista y narración de larga duración, se recomienda evaluar con muestras antes de escalar la producción.

Novedades

Ver el registro de cambios →

Nuevo modelo Ya está disponible el modelo de generación de video flux-3-max/text-to-video Oct 31, 2026
Actualización de precio Ajuste de precio de flux-3-max/text-to-video Oct 31, 2026
Actualización de precio Ajuste de precio de flux-3-max/image-to-video: nueva tarifa de $0.0608 Oct 31, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Qué entradas requiere FLUX 3 Max para generar video a partir de una imagen?

Son obligatorios prompt e image_url (imagen del primer fotograma, compatible con PNG/JPEG/WebP). De forma opcional, end_image_url como fotograma final, así como duration, resolution, aspect_ratio, generate_audio y reasoning_level.
¿Se puede configurar la duración del vídeo?

Sí. duration acepta un número entero de segundos entre 5 y 20, en pasos de 1 segundo, con un valor predeterminado de 5 segundos; la generación de vídeo a partir de imagen y la de texto a vídeo comparten la misma tarifa por segundo. Primero confirma con 5 segundos si la imagen de origen es estable y luego amplía la duración.
¿De qué depende la relación de aspecto?

aspect_ratio es auto por defecto y la salida sigue la proporción de la imagen del primer fotograma; también se puede especificar manualmente 21:9, 2:1, 16:9, 4:3, 1:1, 3:4 o 9:16. Si la especificación manual no coincide con la proporción de la imagen, la imagen puede recortarse.
¿Cómo se usa el fotograma final?

Pasa el primer fotograma en image_url y el fotograma final en end_image_url; el video hará la transición del primer fotograma al fotograma final. En el prompt, describe solo los cambios que ocurren en el medio; cuanto más similares sean el encuadre y la iluminación de las dos imágenes, más fluida será la transición.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: flux-3-max/text-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para flux-3-max/text-to-video y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 1maxLength 6000

Descripción textual del video a generar, que determina el contenido de la imagen y el desarrollo de la escena.

durationintegerOpcionalPredeterminado: 5min 5max 20

Duración del video de salida en segundos; el rango de valores va de 5 a 20, por defecto 5.

resolutionstringOpcionalPredeterminado: "720p"

Resolución del video de salida; por defecto 720p.

Opciones:720p1080p

aspect_ratiostringOpcionalPredeterminado: "auto"

Relación de aspecto del video de salida; por defecto auto, es decir, sigue la imagen de entrada.

Opciones:auto21:92:116:94:31:13:49:16

generate_audiobooleanOpcionalPredeterminado: true

Indica si se genera audio sincronizado con el video; por defecto true.

reasoning_levelstringOpcionalPredeterminado: "high"

Controla la intensidad de razonamiento al analizar el prompt; establecerlo en high puede mejorar el rendimiento en escenas complejas, pero con mayor latencia; por defecto high.

Opciones:lowhigh

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-3-max/text-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "auto",
    "generate_audio": true,
    "reasoning_level": "high"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "flux-3-max/text-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "auto",
      "generate_audio": true,
      "reasoning_level": "high"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "flux-3-max/text-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "resolution": "720p",
          "aspect_ratio": "auto",
          "generate_audio": True,
          "reasoning_level": "high"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}