flux-schnell 文生图模型详情页 Hero 图：左侧大片暖奶油光晕留白，右侧悬浮玻璃浮卡与虹彩光带由右向左流动，冰蓝、珊瑚粉与薰衣草紫渐变，发光立体字 flux-schnell 镌刻于玻璃胶片上。

Black Forest Labs

FLUX.1 Schnell

flux-schnell/text-to-image

Modelo de texto a imagen destilado de Black Forest Labs, transformer de flujo rectificado con 12 mil millones de parámetros, enfocado en la generación rápida de imágenes con baja latencia, ideal para la generación por lotes de imágenes conceptuales y bocetos

flux-schnell/text-to-image

Probar flux-schnell/text-to-image

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

flux-schnell/text-to-image per image

Precio unitario	$0.005

Presentación

FLUX.1-schnell es un modelo de texto a imagen presentado por Black Forest Labs, basado en una arquitectura rectified flow transformer de 12 000 millones de parámetros y optimizado mediante destilación, que genera imágenes de alta calidad con un número reducido de pasos de inferencia y logra un buen equilibrio entre el seguimiento de las indicaciones y la representación de detalles. Se puede invocar este modelo a través de la interfaz unificada de HiAPI.ai, lo que lo hace adecuado para desarrolladores y escenarios de creación de contenido que necesitan producir rápidamente bocetos conceptuales y material visual.

Puntos clave

Arquitectura destilada que genera imágenes rápidamente con pocos pasos: la recomendación oficial es de 1 a 4 pasos de inferencia para completar la generación con eliminación de ruido, lo que lo hace adecuado para escenarios interactivos que exigen velocidad de respuesta.
Equilibrio entre seguimiento de indicaciones y representación de detalles: basado en un rectified flow transformer de 12 000 millones de parámetros, ofrece un buen rendimiento en detalles de imagen y alineación con las indicaciones.
Control flexible de la relación de aspecto y el formato de salida: admite cinco relaciones de aspecto (1:1, 4:3, 3:4, 16:9 y 9:16) y salida en jpeg o png, lo que facilita la adaptación a distintas necesidades de maquetación.

Descripción de capacidades

Generación de texto a imagen: basta con introducir una indicación de texto para generar la imagen correspondiente, ideal para convertir rápidamente descripciones creativas en material visual.

Ajuste de los pasos de inferencia y del coeficiente de guía: se pueden configurar de 1 a 12 pasos de inferencia (la recomendación oficial es de 1 a 4 pasos) y un coeficiente de guía de 1 a 20, para equilibrar según las necesidades la velocidad y el grado de seguimiento de las indicaciones.

Reproducción de resultados con semilla fija: al especificar una semilla aleatoria, se pueden reproducir los resultados de generación con los mismos parámetros, lo que facilita la depuración y la gestión de la coherencia en tareas por lotes.

Interruptor de filtrado de seguridad de contenido: la comprobación de seguridad está activada por defecto, pero también se puede desactivar según sea necesario, lo que permite ajustar con flexibilidad la política de contenido en entornos controlados.

Casos de uso

Generación rápida de bocetos conceptuales por parte de diseñadores: introducir una descripción de escena o estilo para producir rápidamente varios bocetos conceptuales, utilizados en la comunicación creativa temprana y la selección de direcciones.
Desarrolladores que crean aplicaciones de texto a imagen: integrar el modelo en el flujo de trabajo de su propio producto para generar en tiempo real imágenes o material visual a partir de la entrada del usuario.
Generación de imágenes de acompañamiento en la creación de contenido: generar por lotes imágenes de acompañamiento para artículos, redes sociales y otros escenarios con la relación de aspecto y el formato especificados, listas para su publicación directa.

Limitaciones y recomendaciones de selección

Este modelo solo admite la generación de texto a imagen y no cubre otras modalidades como vídeo o texto. Al ser una versión destilada, en escenarios con indicaciones complejas o requisitos de alta precisión su rendimiento podría ser inferior al de los modelos no destilados; los resultados reales dependen de la calidad de las indicaciones, los parámetros de muestreo y el entorno de ejecución. Si se necesitan capacidades multimodales o una generación de imágenes de mayor precisión, se recomienda evaluar otros modelos.

Preguntas frecuentes

Ver todas las preguntas →

¿Para qué tareas es principalmente adecuado FLUX.1 [schnell]?

Un modelo ultrarrápido de bajo coste con 1-4 pasos, adecuado para bocetos, generación de imágenes por lotes y exploración rápida de prompts.
¿FLUX.1 [schnell] admite imágenes de referencia?

La línea actual es de generación de imágenes solo a partir de texto, no acepta imágenes de referencia.
¿Qué especificaciones de salida se admiten?

La página actual muestra 1-12 inference steps y 1:1, 16:9, 9:16, 4:3, 3:4; las opciones finales están sujetas a los parámetros del Playground.
¿Cómo se factura FLUX.1 [schnell]?

Se factura según la cantidad de imágenes generadas con éxito; si hay diferencias según la resolución o el nivel de calidad, se mostrarán en el precio en tiempo real de la página.

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-schnell/text-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcional

Semilla aleatoria para reproducir el resultado de la generación; al pasar la misma semilla se obtiene una salida consistente.

promptstringObligatorio

Indicación de texto utilizada para la generación de la imagen.

aspect_ratiostringOpcionalPredeterminado: "4:3"

Relación de aspecto de la imagen de salida; por defecto 4:3.

Opciones:1:14:33:416:99:16

output_formatstringOpcionalPredeterminado: "jpeg"

Formato de la imagen de salida; por defecto jpeg.

Opciones:jpegpng

guidance_scalenumberOpcionalPredeterminado: 3.5min 1max 20

Controla en qué medida el resultado generado sigue la indicación; por defecto 3.5.

num_inference_stepsintegerOpcionalPredeterminado: 4min 1max 12

Número de pasos de eliminación de ruido; por defecto 4; para el modelo schnell se recomienda 1-4.

enable_safety_checkerbooleanOpcionalPredeterminado: true

Indica si se habilita el filtro de seguridad de contenido; por defecto true.

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-schnell/text-to-image",
  "input": {
    "prompt": "…",
    "aspect_ratio": "4:3",
    "output_format": "jpeg",
    "guidance_scale": 3.5,
    "num_inference_steps": 4,
    "enable_safety_checker": true
  }
}'

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-schnell/text-to-image",
    input: {
      "prompt": "…",
      "aspect_ratio": "4:3",
      "output_format": "jpeg",
      "guidance_scale": 3.5,
      "num_inference_steps": 4,
      "enable_safety_checker": true
    }
  }),
});
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-schnell/text-to-image",
        "input": {
          "prompt": "…",
          "aspect_ratio": "4:3",
          "output_format": "jpeg",
          "guidance_scale": 3.5,
          "num_inference_steps": 4,
          "enable_safety_checker": True
        }
    },
)
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"
    }
  }
}