Black Forest Labs
FLUX.2 Klein 4B
flux-2-klein-4b/text-to-image
Modelo pequeño destilado de 4 mil millones de parámetros que unifica la generación de imágenes a partir de texto y la edición de imágenes, con inferencia de extremo a extremo que puede llegar a menos de 1 segundo y capaz de ejecutarse con aproximadamente 13 GB de memoria de video
Probar flux-2-klein-4b/text-to-image
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
flux-2-klein-4b/text-to-image per image
| Especificaciones | Precio unitario |
|---|---|
| 0.25 MP | $0.00036 |
| 0.5 MP | $0.00072 |
| 1 MP | $0.00143 |
| 2 MP | $0.00286 |
| 4 MP | $0.00572 |
Descripción general
FLUX.2 klein 4B es un modelo compacto de texto a imagen presentado por Black Forest Labs, con una arquitectura rectified flow de 4000 millones de parámetros, destilado del modelo base FLUX.2 de mayor tamaño, del que hereda la comprensión de la iluminación, los materiales y la composición. Es adecuado para desarrolladores que necesitan generar imágenes por lotes a bajo costo y con una integración estable en flujos de trabajo interactivos o sensibles a la latencia. Gracias a la interfaz unificada de HiAPI.ai, basta con enviar el prompt para obtener la imagen final con la resolución y la relación de aspecto deseadas.
Puntos clave
- Tamaño compacto y costo de generación controlable: la escala de 4000 millones de parámetros, junto con la aceleración por destilación, reduce el costo de cada imagen, lo que lo hace idóneo para escenarios de desarrollo que requieren grandes volúmenes y múltiples intentos.
- Destilado de un modelo base FLUX.2 de mayor tamaño: la comprensión de la iluminación, los materiales y la composición proviene de la destilación de un modelo grande, con una calidad que supera lo que cabría esperar para su volumen de parámetros.
- Especificaciones de imagen definidas en una sola llamada: la resolución, la relación de aspecto, el formato de salida y la calidad de compresión son parámetros de la solicitud, de modo que las especificaciones de la imagen se determinan en una única llamada.
- Semilla reproducible: admite el envío de una semilla aleatoria, lo que facilita reproducir o ajustar los resultados de generación para un mismo prompt, útil para depuración y verificación de regresiones.
Descripción de capacidades
Generación de texto a imagen: basta con enviar un prompt de texto para obtener la imagen correspondiente, sin necesidad de una imagen de referencia; el prompt es el único parámetro obligatorio, por lo que la integración es sencilla.
Múltiples niveles de resolución y relaciones de aspecto: la salida admite cinco niveles de resolución de 0,25 a 4 MP y más de diez relaciones de aspecto como 1:1, 16:9 y 21:9, que se ajustan directamente a necesidades de maquetación como imágenes de cabecera o materiales verticales.
Formato de salida y control de calidad: permite elegir entre los formatos webp, jpg y png, y ajustar la calidad de compresión de jpg/webp entre 0 y 100, para equilibrar según se necesite la nitidez y el tamaño del archivo.
Semilla aleatoria reproducible: el parámetro seed permite obtener resultados repetibles con la misma entrada, lo que facilita comparar distintas combinaciones de parámetros y reproducir muestras problemáticas.
Casos de uso
- Generación masiva de imágenes para plataformas de contenido: equipos de operaciones o desarrolladores de backend generan imágenes por lotes con prompts basados en plantillas, especificando la relación de aspecto y el formato webp, y las usan directamente como imágenes de artículos y miniaturas de listados.
- Vista previa instantánea en herramientas de creación interactivas: las aplicaciones de creación convierten en tiempo real la entrada del usuario en imágenes, con una vista previa rápida a baja resolución y, tras la confirmación, la salida final a alta resolución.
- Generación de material de marketing con especificaciones definidas: se eligen proporciones como 16:9 o 9:16 y la resolución objetivo según el canal de difusión, y una sola llamada produce banners y portadas listos para publicar.
- Ajuste de parámetros y verificación de regresiones de los resultados: con seed y los parámetros de calidad se realizan comparaciones A/B, y las muestras reproducibles se consolidan como biblioteca de prompts y línea base de calidad.
Limitaciones y recomendaciones de selección
Solo admite texto a imagen; cuando se requiera editar una imagen existente o imponer restricciones mediante una imagen de referencia, debe elegirse la línea de edición de imágenes. El modelo es una versión destilada de 4B, por lo que su límite de capacidad está condicionado por la escala de parámetros y su estabilidad en composiciones complejas, texto denso y detalles finos es menor que la de modelos más grandes; para este tipo de necesidades de alta precisión se recomienda optar por modelos de mayor tamaño. La resolución y la relación de aspecto son enumeraciones predefinidas y no admiten salidas de tamaño arbitrario. Actualmente no se dispone de datos de referencia transversales independientes, por lo que la selección debería basarse en pruebas reales con prompts propios.
Preguntas frecuentes
Ver todas las preguntas →-
¿Para qué tareas es adecuado FLUX.2 [klein] 4B?
Es adecuado para borradores por lotes, conceptos de productos, materiales para redes sociales e iteración visual sensible a costes. Cuando se necesita mayor realismo, texto y detalle, se puede usar 9B.
-
¿Cómo elegir entre 0.25 MP y 4 MP?
Para bocetos y miniaturas se puede usar primero 0.25 o 0.5 MP; para recursos web habituales, 1 MP; cuando se necesita una salida mayor, elegir 2 o 4 MP. El precio varía según el nivel de píxeles.
-
¿Qué relaciones de aspecto se admiten?
Se admiten 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 21:9 y 9:21.
-
¿Cómo reproducir la misma dirección de composición?
Fija la semilla (Seed), el Prompt, el formato, el nivel de píxeles y la configuración de salida; modifica solo una variable para comparar.
Crear una tarea de generación
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl 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-KeystringOpcionalClave 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.
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
modelstringObligatorioValor fijo actual: flux-2-klein-4b/text-to-image
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para flux-2-klein-4b/text-to-image y la ruta default; consulta la tabla de parámetros a continuación.
seedintegerOpcionalSemilla aleatoria para controlar la reproducibilidad de los resultados generados; la misma semilla con la misma entrada produce una salida idéntica. El valor es un número entero.
promptstringObligatorioIndicación de texto para la generación de imágenes que describe el contenido visual deseado. El valor es una cadena de texto.
resolutionstringOpcionalPredeterminado: "1 MP"Tamaño de la imagen de salida, especificado en megapíxeles (MP). El valor predeterminado es 1 MP.
0.25 MP0.5 MP1 MP2 MP4 MPaspect_ratiostringOpcionalPredeterminado: "1:1"Relación de aspecto de la imagen generada. El valor predeterminado es 1:1.
1:116:99:163:22:34:33:45:4Mostrar todo (3)
4:521:99:21output_formatstringOpcionalPredeterminado: "jpg"Formato de salida de la imagen generada. El valor predeterminado es jpg.
webpjpgpngoutput_qualityintegerOpcionalPredeterminado: 95min 0max 100Calidad de compresión de la salida en jpg y webp. El valor predeterminado es 95. El valor es un número entero.
callbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
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.
urlstringObligatorioObligatorio 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.
finalstoragestringOpcionalPredeterminado: "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.
temppersistentEjemplos 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-4b/text-to-image",
"input": {
"prompt": "…",
"resolution": "1 MP",
"aspect_ratio": "1:1",
"output_format": "jpg",
"output_quality": 95
}
}' 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-4b/text-to-image",
input: {
"prompt": "…",
"resolution": "1 MP",
"aspect_ratio": "1:1",
"output_format": "jpg",
"output_quality": 95
}
}),
});
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-4b/text-to-image",
"input": {
"prompt": "…",
"resolution": "1 MP",
"aspect_ratio": "1:1",
"output_format": "jpg",
"output_quality": 95
}
},
)
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
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre 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.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
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.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos 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
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripció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"
}
}
} Artículos
Ver todos los artículos →-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video en HiAPI: curl + Python
Realiza una solicitud de imagen a video funcional en HiAPI: desde la carga del primer fotograma hasta el sondeo asíncrono y la descarga final
-
Tutorial
Cómo llamar a hailuo-2.3-fast/image-to-video a través de la API de HiAPI: práctica con curl y Python
La primera solicitud ejecutable del nivel rápido y de bajo coste de imagen a vídeo: del ID del modelo a la descarga del MP4
-
Tutorial
Cómo usar kling-4.0/text-to-video a través de la API de HiAPI: curl, Python y un ejemplo de solicitud ejecutable
Guía práctica para desarrolladores: prompts cinematográficos, audio sincronizado, sondeo asíncrono y descarga de resultados
-
Tutorial
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
Tutorial
Cómo llamar a kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
Tutorial
Uso de Kandinsky 6.0 Pro texto a video en HiAPI: tutorial con curl y Python
Demostración práctica centrada en la solicitud: construir la llamada de prompt a clip de video, enviar la solicitud, sondear el estado de finalización y descargar el resultado
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
Wan 2.7 Image Alibaba $0.035 /imagen -
Seedream 5.0 ByteDance $0.025 /imagen -
BRIA Eraser Bria $0.058 /imagen -
FLUX.1 Fill Pro Black Forest Labs $0.071 /imagen -
Grok Imagine Image 2.0 xAI $0.052 /imagen -
Nano Banana 2 Google $0.036 /imagen -
Qwen Image 2.1 Alibaba $0.020 /imagen -
Krea 2 Medium Turbo Krea $0.021 /imagen -
Krea 3 Krea $0.036 /imagen -
Ideogram V4.5 Ideogram $0.011 /imagen -
Muse Image 1.0 Meta $0.015 per task -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /imagen
Mismo proveedor
-
FLUX 3 Image Black Forest Labs $0.041 /imagen -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /imagen -
FLUX.1 Fill Pro Black Forest Labs $0.071 /imagen -
FLUX 3 Video Black Forest Labs $0.090 /segundo -
FLUX.1 Schnell Black Forest Labs $0.005 /imagen -
FLUX.1 Kontext Max Black Forest Labs $0.071 /imagen -
FLUX 3 Max Black Forest Labs $0.061 /segundo -
FLUX.2 Black Forest Labs $0.035 /imagen -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /imagen -
FLUX 1.1 Pro Black Forest Labs $0.050 /imagen


