Black Forest Labs

FLUX 3 Image Klein

flux-3-image-klein

Probar flux-3-image-klein

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

flux-3-image-klein per image

Especificaciones	Precio unitario
768	$0.0092
1K	$0.0103
1.5K	$0.0126
2K	$0.016
4K	$0.0412

Descripción general

Este es un modelo orientado a escenarios de generación y edición de imágenes: permite generar imágenes únicamente a partir de un prompt y también modificar o componer la escena siguiendo instrucciones cuando se proporciona una imagen de referencia. La entrada puede incluir hasta 10 imágenes de referencia, y se pueden usar etiquetas junto con cuadros delimitadores para describir la disposición y las regiones locales. La salida es una imagen estática, con opciones de resolución de 768 a 4K píxeles y diversas proporciones horizontales y verticales. Es adecuado para desarrolladores y equipos de diseño que necesitan producir material visual por lotes, continuar el estilo de imágenes de referencia o controlar la composición.

Puntos clave

Generación desde texto y edición con imágenes de referencia combinadas: el mismo modelo acepta tanto la generación a partir de un prompt puro como la modificación y composición a partir de imágenes de referencia más instrucciones.
Combinación de hasta diez imágenes de referencia: en una sola solicitud se pueden enviar varias imágenes de referencia, para composición con múltiples imágenes o para asignar distintos papeles de sujeto y estilo a cada imagen.
Opciones de salida hasta 4K: la resolución se elige entre 768, 1K, 1.5K, 2K y 4K; el ancho y el alto varían según la proporción de aspecto seleccionada.
Control de disposición con cuadros delimitadores: en el prompt se pueden usar etiquetas junto con un JSON de cuadros delimitadores para especificar la posición de los elementos y editar regiones locales.

Descripción de capacidades

Generación de imágenes solo con prompt: basta con enviar un prompt para producir una imagen; el prompt admite hasta 5000 caracteres. Si no se envían imágenes de referencia, el modo es texto a imagen, adecuado para construir una escena desde cero.

Edición mediante instrucciones con imágenes de referencia: al enviar imágenes de referencia e indicar en el prompt qué contenido modificar y qué conservar, se pueden realizar ajustes dirigidos de la escena; se admiten hasta 10 imágenes de referencia.

Múltiples imágenes de referencia y control de disposición: varias imágenes de referencia pueden asumir por separado roles de sujeto, estilo o composición, y combinarse con etiquetas y un JSON de cuadros delimitadores para especificar la colocación de elementos, lo que facilita organizar escenas complejas.

Selección de proporción y formato: la proporción de aspecto se puede elegir entre múltiples composiciones horizontales y verticales de 21:9 a 9:21, o en modo automático; el formato de salida es jpeg o png.

Pasos ajustables y semilla aleatoria: los pasos de difusión son ajustables de 1 a 16; con menos pasos la generación es más rápida, pero el detalle puede reducirse. Especificar una semilla de 0 a 4294967295 permite reproducir en la medida de lo posible el resultado con los mismos parámetros.

Casos de uso

Retoque de material para comercio electrónico y marketing: el personal de operaciones sube una imagen de referencia del producto y adjunta instrucciones de modificación para obtener la imagen principal o una variante ajustada, que se usa en la página de detalles del producto y en los espacios de material de campaña.
Composición de estilos con múltiples imágenes de referencia: el diseñador envía una imagen del sujeto y una imagen de referencia de estilo para componer un borrador visual con una tonalidad unificada, destinado a imágenes de promoción de marca y a ilustraciones para redes sociales.
Generación de carteles con control de composición: el equipo de marketing usa prompts junto con cuadros delimitadores para describir la posición del título y de los elementos, y produce anuncios en formato horizontal o vertical para publicación y previsualización de impresión.
Producción de imágenes finales de alta resolución: el equipo de contenido elige la opción de 2K o 4K para generar imágenes finales, destinadas a páginas de exhibición y salidas de material que requieren un tamaño de píxeles mayor.
Validación de prototipos de imágenes por lotes: el desarrollador genera rápidamente varios conjuntos de bocetos con una semilla fija y menos pasos, para filtrar direcciones creativas y comparar propuestas tempranas.

Limitaciones y recomendaciones de selección

El prompt de entrada debe tener entre 1 y 5000 caracteres, y las imágenes de referencia deben ser enlaces de imagen http o https accesibles, con un máximo de 10. En cada solicitud, la resolución, la proporción de aspecto y el formato de salida se configuran eligiendo una sola opción. El límite de pasos de difusión es 16; con menos pasos el detalle puede reducirse. Las opciones de resolución describen el nivel de píxeles de salida, y el ancho y el alto concretos varían según la proporción. La semilla solo sirve para reproducir en la medida de lo posible el resultado con los mismos parámetros y no garantiza una coincidencia total; la tolerancia de seguridad de contenido va de 0 a 4, siendo 0 la más estricta.

Novedades

Ver el registro de cambios →

Nuevo modelo Nuevo modelo disponible: FLUX 3 Image Klein Nov 11, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Por qué las imágenes generadas con prompts breves resultan tan genéricas?

Con un prompt corto hay muy poca información, así que el modelo solo puede completar según las interpretaciones habituales y el resultado tiende a ser genérico. Escribir el prompt como una descripción completa es mucho más estable: ① sujeto y detalles de apariencia ② escena y entorno ③ luz y tonalidad ④ composición y punto de vista ⑤ requisitos de estilo y calidad de imagen. El prompt admite hasta 5000 caracteres, suficiente para detallar cada punto.
¿Cómo se alterna entre texto a imagen y edición de imágenes?

El mismo modelo tiene dos modos de uso; la única diferencia es si se pasa una imagen de referencia. Omitir image_urls equivale a texto a imagen: se genera solo según el prompt. Al pasar image_urls, el modelo cambia a edición por instrucciones, y el prompt debe indicar con claridad qué partes de la imagen de referencia hay que modificar y cuáles conservar. Al editar, se recomienda enumerar punto por punto las zonas que se van a cambiar y el efecto esperado, en lugar de escribir solo una frase sobre el estilo general.
¿Cuántas imágenes de referencia se pueden usar como máximo?

image_urls admite como máximo 10 imágenes y como mínimo 1; si se envían imágenes de referencia, se entra en el modo de edición o de síntesis con múltiples referencias. En el prompt debe indicarse el rol de cada imagen, por ejemplo, la primera es el personaje, la segunda es el producto y la tercera es el estilo del fondo. Este límite superior es adecuado para escenarios de síntesis que requieren consistencia de personajes o productos entre imágenes.
¿Cómo se controla la disposición del diseño?

Usa las etiquetas del prompt junto con un JSON de bbox para especificar la posición de los elementos. En el prompt, escribe marcadores de posición con la forma <etiqueta> y adjunta el JSON de cuadros delimitadores correspondiente, indicando en qué región se coloca cada elemento, y luego incluye la descripción concreta dentro del contenido correspondiente a cada etiqueta. Es adecuado para imágenes como carteles y banners que requieren posiciones de maquetación fijas.

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-image-klein

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para flux-3-image-klein y la ruta default; consulta la tabla de parámetros a continuación.

seedintegerOpcionalmin 0max 4294967295

Semilla aleatoria para reproducir en la medida de lo posible el mismo resultado con los mismos parámetros; se toma un número entero, si se omite se genera de forma aleatoria.

stepsintegerOpcionalPredeterminado: 16min 1max 16

Número de pasos de difusión, rango de 1 a 16, por defecto 16; cuanto menor sea el valor, más rápida será la generación, aunque puede reducirse el detalle, sin afectar el precio.

promptstringObligatoriominLength 1maxLength 5000

Describe la imagen que se desea generar, o indica el contenido de la imagen de referencia que debe modificarse y conservarse; se puede combinar con <etiquetas> y bbox JSON para especificar la disposición y las zonas de edición local.

image_urlsarrayOpcionalminItems 1maxItems 10

Arreglo de imágenes de referencia, cuyos elementos son direcciones de imagen; es necesario indicar en el prompt el sujeto, el estilo o el rol compositivo de cada imagen; si se omite, se trata de generación de imagen a partir de texto.

Array [ string ]

resolutionstringOpcionalPredeterminado: "1K"

Nivel de píxeles de salida; el ancho y alto concretos varían según la relación de aspecto; por defecto 1K.

Opciones:7681K1.5K2K4K

aspect_ratiostringOpcionalPredeterminado: "auto"

Relación de aspecto de salida, puede ser horizontal, vertical o cuadrada; por defecto auto; el modo automático determina la relación de aspecto según el prompt y las imágenes de referencia.

Opciones:21:92:116:93:27:54:35:41:1

Mostrar todo (8)Mostrar menos

4:53:45:72:39:161:29:21auto

output_formatstringOpcionalPredeterminado: "jpeg"

Formato de la imagen de salida; por defecto jpeg.

Opciones:jpegpng

safety_toleranceintegerOpcionalPredeterminado: 2min 0max 4

Tolerancia de seguridad del contenido, se toma un número entero, 0 es el más estricto; por defecto 2.

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-image-klein",
  "input": {
    "steps": 16,
    "prompt": "…",
    "resolution": "1K",
    "aspect_ratio": "auto",
    "output_format": "jpeg",
    "safety_tolerance": 2
  }
}'

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-image-klein",
    input: {
      "steps": 16,
      "prompt": "…",
      "resolution": "1K",
      "aspect_ratio": "auto",
      "output_format": "jpeg",
      "safety_tolerance": 2
    }
  }),
});
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-image-klein",
        "input": {
          "steps": 16,
          "prompt": "…",
          "resolution": "1K",
          "aspect_ratio": "auto",
          "output_format": "jpeg",
          "safety_tolerance": 2
        }
    },
)
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"
    }
  }
}