Black Forest Labs

FLUX.2 Klein 9B

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

Precio unitario	$0.03143

Descripción general

Modelo de edición de imágenes basado en la arquitectura FLUX.2 klein 9B, invocado mediante la interfaz unificada de HiAPI.ai. Recibe una imagen de referencia y una instrucción de edición, y ajusta el contenido y el estilo de la imagen original según la descripción, con soporte para especificar la relación de aspecto y el formato de salida. Es adecuado para desarrolladores que necesitan completar iteraciones rápidas mediante imagen a imagen y buscan efectos de edición de baja latencia; puede usarse en diseño de prototipos, recreación de contenido y otros escenarios.

Aspectos destacados

Edición por instrucciones basada en una sola imagen de referencia: basta con subir una imagen de referencia y proporcionar una descripción de edición; el modelo modifica la imagen según la instrucción, sin necesidad de máscaras adicionales ni preprocesamiento complejo.
Inferencia de pocos pasos, de 4 a 8: utiliza destilación de pasos; el número de pasos de inferencia puede ajustarse entre 4 y 8, lo que permite un equilibrio flexible entre calidad y latencia.
Relación de aspecto y formato de salida configurables: admite cinco relaciones de aspecto (1:1, 4:3, 3:4, 16:9, 9:16) y tres formatos de salida (jpeg, png, webp), lo que facilita la integración directa con flujos posteriores.

Descripción de capacidades

Edición por instrucciones con imagen de referencia: se introduce una imagen jpeg/png/webp y una descripción de edición en texto, y el modelo genera la imagen modificada a partir de ellos; es adecuado para validar rápidamente ideas de edición.

Pasos de inferencia ajustables: num_inference_steps admite enteros de 4 a 8; cuantos más pasos, más detalle, y cuantos menos, más rápida la respuesta, por lo que puede elegirse según el escenario.

Especificaciones de salida controladas: permite especificar la relación de aspecto y el formato de archivo de la imagen generada, lo que reduce los pasos posteriores de recorte y transcodificación y permite usarla directamente para visualización o almacenamiento.

Generación reproducible: mediante el parámetro seed se fija la semilla aleatoria, lo que facilita reproducir el mismo resultado de edición durante la depuración y la comparación.

Escenarios de aplicación

Iteración rápida de propuestas visuales por parte de diseñadores: subir una imagen de referencia de estilo y describir con texto la dirección de ajuste, generar varias versiones de imágenes editadas y usarlas para filtrar conceptos y comunicarse con clientes.
Recreación de imágenes por creadores de contenido: introducir instrucciones de edición basadas en imágenes de material existentes y generar imágenes con estilo o contenido ajustado para redes sociales e ilustraciones de artículos.
Validación del flujo de imagen a imagen durante la integración de desarrollo: generar imágenes rápidamente con una seed fija y pocos pasos de inferencia para validar los parámetros de la interfaz y el pipeline posterior, y usar los resultados en pruebas de integración.

Limitaciones y recomendaciones de selección

Solo admite una única imagen de referencia como entrada, y la imagen de entrada se escala a 1 MP, por lo que la conservación de detalles en alta resolución es limitada; no admite el formato svg. El límite de pasos de inferencia es 8, lo que puede resultar insuficiente para necesidades de muy alta calidad o control preciso. Este modelo se centra en la edición de imágenes y no cubre modalidades como vídeo o audio. Si se necesita texto a imagen puro o salidas de mayor resolución, conviene evaluar otras variantes de la misma familia o modelos con las capacidades correspondientes.

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

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para flux-2-klein-9b/image-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; se toma un número entero y con la misma semilla se obtiene una salida idéntica.

promptstringObligatorio

Prompt: describe con texto la edición que se debe realizar sobre la imagen de referencia.

image_urlsarrayObligatoriominItems 1maxItems 1

Arreglo de imágenes de referencia; solo se necesita una imagen. Admite formatos jpeg, png y webp; no admite svg. La imagen de entrada se escala a 1 MP.

Array [ string ]

aspect_ratiostringOpcionalPredeterminado: "1:1"

Relación de aspecto de la imagen generada, como cadena de texto; por defecto 1:1.

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

output_formatstringOpcionalPredeterminado: "png"

Formato de salida de la imagen generada, como cadena de texto; por defecto png.

Opciones:jpegpngwebp

num_inference_stepsintegerOpcionalPredeterminado: 4min 4max 8

Número de pasos de inferencia, un entero entre 4 y 8; por defecto 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/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "aspect_ratio": "1:1",
    "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/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "aspect_ratio": "1:1",
      "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/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "aspect_ratio": "1:1",
          "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"
    }
  }
}