Black Forest Labs
FLUX.2 Klein 4B
flux-2-klein-4b/image-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/image-to-image
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
flux-2-klein-4b/image-to-image per image
| Especificaciones | Precio unitario |
|---|---|
| 0.25 MP | $0.00608 |
| 0.5 MP | $0.00643 |
| 1 MP | $0.00715 |
| 2 MP | $0.00858 |
| 4 MP | $0.01143 |
Descripción general
FLUX.2 klein 4B es un modelo de edición de imágenes de 4 mil millones de parámetros lanzado por Black Forest Labs, que admite la entrada de una única imagen de referencia y realiza modificaciones controladas sobre la imagen original mediante instrucciones. Los desarrolladores pueden especificar la resolución de salida (0,25–4 MP), la relación de aspecto, el formato y la calidad de compresión, además de fijar una semilla aleatoria para reproducir los resultados. Es adecuado para desarrolladores que necesitan validar rápidamente flujos de edición de imágenes y para equipos que integran la reedición de imágenes de referencia en prototipos de aplicaciones.
Aspectos destacados
- Edición por instrucciones con una sola imagen de referencia: basta con proporcionar una imagen de referencia y un prompt de edición para completar modificaciones dirigidas sobre la imagen original, sin necesidad de construir un pipeline de edición adicional.
- Control preciso de los parámetros de salida: admite especificar la resolución (0,25–4 MP), la relación de aspecto, el formato de salida y la calidad de compresión, y permite reproducir el mismo resultado mediante una semilla.
- Modelo destilado de tamaño compacto: los 4B parámetros se destilaron de una base FLUX.2 más grande, lo que mantiene la comprensión de la iluminación y los materiales mientras reduce el umbral de despliegue.
Descripción de capacidades
Edición de imágenes por instrucciones: se introduce una imagen de referencia y un prompt, y el modelo ejecuta modificaciones sobre la imagen de referencia según la descripción, generando un resultado de edición directamente utilizable en flujos posteriores.
Control de resolución y proporción de salida: la resolución se puede seleccionar entre 0,25 MP y 4 MP, y la relación de aspecto puede coincidir con la imagen original o especificarse entre proporciones habituales, satisfaciendo los requisitos de distintos espacios de visualización.
Formato y calidad ajustables: admite salida en webp, jpg y png, y permite establecer la calidad de compresión (0–100), lo que facilita el equilibrio entre calidad de imagen y tamaño de archivo.
Resultados reproducibles: mediante el parámetro seed, se puede reproducir el mismo resultado de edición con las mismas entradas, lo que facilita la depuración y la verificación de consistencia en tareas por lotes.
Escenarios de aplicación
- Validación rápida de flujos de edición de imágenes por desarrolladores: probar el efecto de edición con una sola imagen de referencia y un prompt, generando imágenes de muestra reproducibles para evaluar si integrar en el pipeline de producción.
- Reedición con consistencia de estilo en imágenes de producto: a partir de una imagen de referencia de producto, ajustar el estilo o los detalles según instrucciones y generar imágenes con especificaciones uniformes para exhibición o bibliotecas de materiales.
- Prototipos de edición interactiva en tiempo real: integrar la capacidad de reedición de imágenes de referencia en herramientas interactivas, generando vistas previas de hasta 0,25 MP para retroalimentación inmediata.
Limitaciones y recomendaciones de selección
Solo acepta una única imagen de referencia y no puede restringir varias imágenes simultáneamente; las imágenes de entrada que superen los 4 MP se comprimirán a 4 MP y no se admite el formato SVG. Al ser un modelo destilado pequeño de 4B, su límite de capacidad está condicionado por la escala; en escenarios de edición compleja o que requieran alta fidelidad de detalles, se recomienda evaluar modelos más grandes. Actualmente no se dispone de datos comparativos independientes, por lo que antes de un uso comercial es necesario verificar la licencia completa y las condiciones de uso.
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/image-to-image
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para flux-2-klein-4b/image-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; se toma un número entero; con la misma semilla y la misma entrada se obtienen resultados consistentes.
promptstringObligatorioIndicación (prompt) que describe la edición a realizar sobre la imagen de referencia; se toma una cadena de texto.
image_urlsarrayObligatoriominItems 1maxItems 1Array de imágenes de referencia, cuyos elementos son la URL de cada imagen de referencia; admite formatos jpeg, png y webp, no admite svg; las imágenes de más de 4 MP se comprimen a 4 MP.
Array [ string ]
resolutionstringOpcionalPredeterminado: "1 MP"Resolución de la imagen de salida, que especifica el tamaño de salida en unidades de megapíxeles; por defecto 1 MP.
0.25 MP0.5 MP1 MP2 MP4 MPaspect_ratiostringOpcionalPredeterminado: "match_input_image"Relación de aspecto de la imagen de salida; si se establece en match_input_image, se mantiene la proporción original de la imagen de referencia; por defecto match_input_image.
match_input_image1:116:99:163:22:34:33:4Mostrar todo (4)
5:44:521:99:21output_formatstringOpcionalPredeterminado: "jpg"Formato de salida de la imagen generada; por defecto jpg.
webpjpgpngoutput_qualityintegerOpcionalPredeterminado: 95min 0max 100Calidad de compresión de la imagen de salida, solo aplicable a los formatos jpg y webp; se toma un número entero; por defecto 95.
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/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "1 MP",
"aspect_ratio": "match_input_image",
"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/image-to-image",
input: {
"prompt": "…",
"image_urls": "…",
"resolution": "1 MP",
"aspect_ratio": "match_input_image",
"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/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"resolution": "1 MP",
"aspect_ratio": "match_input_image",
"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
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
-
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-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 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
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
Nano Banana Pro Google $0.057 /imagen -
FLUX 3 Image Black Forest Labs $0.041 /imagen -
Krea 3 Krea $0.036 /imagen -
Grok Imagine Quality xAI $0.070 /imagen -
Nano Banana 2 Lite Google $0.033 /imagen -
Imagen 4 Google $0.030 /imagen -
Seedream 5.0 ByteDance $0.025 /imagen -
Recraft Creative Upscale Recraft $0.357 /imagen -
Ideogram V4 Ideogram $0.050 /imagen -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /imagen -
FASHN Tryon v1.6 FASHN $0.107 /imagen -
FLUX 1.1 Pro Black Forest Labs $0.050 /imagen
Mismo proveedor
-
FLUX.1 Schnell Black Forest Labs $0.005 /imagen -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /imagen -
FLUX 1.1 Pro Black Forest Labs $0.050 /imagen -
FLUX.2 Black Forest Labs $0.035 /imagen -
FLUX 3 Image Black Forest Labs $0.041 /imagen -
FLUX.1 Kontext Max Black Forest Labs $0.071 /imagen -
FLUX 3 Video Black Forest Labs $0.090 /segundo -
FLUX 3 Max Black Forest Labs $0.061 /segundo -
FLUX.1 Fill Pro Black Forest Labs $0.071 /imagen







