Black Forest Labs

FLUX 3 Image Klein

flux-3-image-klein

Probar flux-3-image-klein

Entrada

Salida

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

Presentación en preparación

Estamos preparando una guía detallada de este modelo. Los precios, parámetros y la documentación de la API ya están disponibles abajo.

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

随机种子，用于尽量复现相同参数下的结果。省略时随机。

stepsintegerOpcionalPredeterminado: 16min 1max 16

扩散步数，1–16；数值越低生成越快，细节可能减少，不影响价格。

promptstringObligatoriominLength 1maxLength 5000

描述想生成的画面，或说明参考图中需要修改与保留的内容。可用 <标签> 配合 bbox JSON 指定布局与局部编辑区域。

image_urlsarrayOpcionalminItems 1maxItems 10

提供参考图片，并在提示词中说明每张图片的主体、风格或构图角色。省略即为文生图。

Array [ string ]

resolutionstringOpcionalPredeterminado: "1K"

选择输出像素档位；具体宽高随画幅变化。

Opciones:7681K1.5K2K4K

aspect_ratiostringOpcionalPredeterminado: "auto"

选择横图、竖图或方图；自动模式根据提示词与参考图确定画幅。

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"

输出图片格式。

Opciones:jpegpng

safety_toleranceintegerOpcionalPredeterminado: 2min 0max 4

内容安全宽容度，0 最严格。

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"
    }
  }
}