Black Forest Labs

FLUX.2 Klein 9B

flux-2-klein-9b/text-to-image

Modelo de imagen de flujo rectificado de 9 mil millones de parámetros, destilado a 4 pasos, que unifica la generación de texto a imagen y la edición con una o varias imágenes de referencia en una arquitectura compacta, orientado a escenarios de generación en tiempo real con baja latencia

flux-2-klein-9b/image-to-image flux-2-klein-9b/text-to-image

Probar flux-2-klein-9b/text-to-image

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

flux-2-klein-9b/text-to-image per image

Precio unitario	$0.00858

Descripción general

La línea de generación de imágenes exclusivamente a partir de texto de FLUX.2 klein 9B, presentada por Black Forest Labs, se centra en el equilibrio entre calidad y latencia. Genera imágenes directamente a partir de indicaciones de texto, admite la selección de relaciones de aspecto de 1:1 a 16:9, así como tres formatos de salida: jpeg, png y webp; el número de pasos de inferencia puede ajustarse entre 4 y 8, y con los 4 pasos predeterminados ya se completa la generación. Es adecuada para la producción masiva de contenido sensible a la velocidad de generación, la ilustración de marketing y la exploración visual en la fase de prototipado; los desarrolladores pueden integrarla mediante la interfaz unificada de HiAPI.ai.

Puntos clave

Inferencia con pocos pasos, orientada a escenarios sensibles a la latencia: el diseño de destilación de pasos permite completar la generación en 4 pasos, y el parámetro puede ajustarse entre 4 y 8 pasos, lo que facilita la elección entre velocidad y detalle.
Compatibilidad con seed fija para una generación reproducible: ofrece el parámetro seed; la misma combinación de indicación y seed permite reproducir resultados, lo que facilita las pruebas de regresión y la comparación entre versiones.
Parámetros de salida adaptados a la canalización de ingeniería: las relaciones de aspecto cubren composiciones habituales como 1:1, 4:3, 3:4, 16:9 y 9:16, y la salida puede elegirse directamente en jpeg, png o webp, lo que evita transcodificaciones adicionales.

Descripción de capacidades

Generación de texto a imagen: basta con introducir una indicación de texto para obtener la imagen correspondiente, sin imagen de referencia obligatoria; solo se requiere el prompt, y el resto de parámetros tienen valores predeterminados, por lo que el costo de integración es bajo.

Control de pasos de inferencia y seed: num_inference_steps puede ajustarse entre 4 y 8 para cambiar el nivel de detalle de la generación; seed sirve para fijar la aleatoriedad, adecuado para evaluaciones y depuraciones que requieren una reproducción estable.

Relación de composición y formato de salida: aspect_ratio cubre cinco proporciones verticales, horizontales y cuadradas; output_format admite jpeg, png y webp, y los resultados generados pueden ajustarse directamente a los espacios de página y a los requisitos de almacenamiento.

Escenarios de aplicación

Producción masiva de ilustraciones para equipos de contenido: generar ilustraciones por lotes a partir de descripciones de productos o temas, especificando la proporción y el formato de salida para usarlas directamente en artículos, landing pages y materiales para redes sociales.
Exploración de bocetos visuales para prototipos de producto: generar rápidamente varias propuestas de composición con indicaciones breves y, junto con una seed fija, reproducir los estilos candidatos para seleccionar direcciones antes de la revisión de diseño.
Integración en aplicaciones de generación en tiempo real o de alta frecuencia: para funciones en línea sensibles a la latencia, generar imágenes con los 4 pasos de inferencia predeterminados y ajustar los pasos según sea necesario para controlar la calidad y el tiempo de ejecución.

Limitaciones y recomendaciones de selección

Esta línea genera imágenes exclusivamente a partir de texto y no acepta imágenes de referencia; cuando se requiera editar o cambiar el estilo de una imagen existente, debe elegirse la línea de imagen a imagen de la misma serie. Los pasos de inferencia solo admiten de 4 a 8 pasos y no permiten ajustes de muestreo prolongado más detallados; además del prompt, no hay parámetros como indicaciones negativas. La tarjeta del modelo impone restricciones al uso fuera de rango, por lo que antes de un uso comercial es necesario verificar el texto original de la licencia. Si la tarea requiere salidas de otras modalidades, como vídeo o audio, este modelo no es aplicable.

Preguntas frecuentes

Ver todas las preguntas →

¿Cuántas imágenes de referencia admite la edición de imágenes de FLUX.2 [klein] 9B?

Actualmente admite 1 imagen de referencia en formato JPEG, PNG o WebP. image_urls debe ser un arreglo que contenga únicamente una URL pública de imagen.
¿Para qué tareas de edición es adecuado?

Es adecuado para la limpieza de imágenes de productos, la sustitución de fondos, la reescritura de texto en la imagen, la modificación de la paleta de colores y el retoque comercial que requiere conservar el sujeto y el ángulo de cámara.
¿Cómo se configura el número de pasos de inferencia?

num_inference_steps admite enteros de 4 a 8, con un valor predeterminado de 4. El precio actual no varía según el número de pasos de inferencia.
¿Qué relaciones de aspecto y formatos son compatibles?

Las relaciones de aspecto compatibles son 1:1, 4:3, 3:4, 16:9 y 9:16; los formatos compatibles son JPEG, PNG y WebP.

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-2-klein-9b/text-to-image

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

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

seedintegerOpcional

Semilla aleatoria para garantizar la reproducibilidad de los resultados de generación; se indica como número entero.

promptstringObligatorio

Prompt de texto utilizado para la generación de la imagen; se indica como cadena de texto.

aspect_ratiostringOpcionalPredeterminado: "4:3"

Relación de aspecto de la imagen generada; se indica como cadena de texto. Valor predeterminado: 4:3.

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

output_formatstringOpcionalPredeterminado: "png"

Formato de salida de la imagen generada; se indica como cadena de texto. Valor predeterminado: png.

Opciones:jpegpngwebp

num_inference_stepsintegerOpcionalPredeterminado: 4min 4max 8

Número de pasos de inferencia; se indica como un número entero entre 4 y 8. Valor predeterminado: 4.

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-2-klein-9b/text-to-image",
  "input": {
    "prompt": "…",
    "aspect_ratio": "4:3",
    "output_format": "png",
    "num_inference_steps": 4
  }
}'

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-2-klein-9b/text-to-image",
    input: {
      "prompt": "…",
      "aspect_ratio": "4:3",
      "output_format": "png",
      "num_inference_steps": 4
    }
  }),
});
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-2-klein-9b/text-to-image",
        "input": {
          "prompt": "…",
          "aspect_ratio": "4:3",
          "output_format": "png",
          "num_inference_steps": 4
        }
    },
)
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"
    }
  }
}