Black Forest Labs
FLUX 1.1 Pro
flux-1.1-pro
Modelo insignia de texto a imagen de Black Forest Labs; genera aproximadamente 6 veces más rápido que Flux.1 Pro, con mejor adherencia a las instrucciones, ideal para generar imágenes a escala
Probar flux-1.1-pro
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
flux-1.1-pro per image
| Precio unitario | $0.050 |
|---|
Introducción y posicionamiento
flux-1.1-pro es un modelo de texto a imagen e imagen a imagen de Black Forest Labs orientado a entornos de producción, al que los desarrolladores acceden mediante la interfaz unificada de HiAPI.ai. Permite generar imágenes directamente a partir de indicaciones de texto y también admite una URL de imagen de referencia para la generación condicionada por imagen; su fidelidad a las indicaciones es buena, por lo que resulta adecuado para flujos de trabajo que requieren una producción estable de imágenes de alta calidad. Cubre relaciones de aspecto habituales como 1:1, 16:9, 3:2, 4:5 y 9:16, y también permite tamaños personalizados; el formato y la calidad de salida son ajustables, lo que facilita su integración en cadenas de generación masiva y producción automatizada.
Puntos clave
- Doble modo de texto a imagen e imagen a imagen: la misma interfaz permite generar solo con indicaciones de texto o pasar una URL de imagen de referencia para una generación condicionada por imagen, lo que reduce el cambio entre varios modelos.
- Control de generación reproducible: admite un seed fijo, por lo que las llamadas repetidas producen resultados consistentes, lo que facilita las pruebas de regresión y la reproducción de tareas por lotes.
- Parámetros de salida ajustables según necesidad: ofrece relación de aspecto, tamaño personalizado, formatos webp/jpg/png y opciones de calidad de salida, adaptándose a distintos usos posteriores.
- Diseñado para flujos de trabajo de producción: su estructura de parámetros es completa y adecuada para integrarse en procesos de generación masiva automatizada y entrega estable.
Descripción de capacidades
Generación de imágenes a partir de texto: genera imágenes directamente usando el prompt como entrada principal, ideal para la creación y producción de material desde cero.
Generación condicionada por imagen de referencia: permite pasar mediante image_prompt una URL de imagen de referencia en jpeg, png, gif o webp para generar a partir de una base visual existente.
Control de formato y tamaño: incluye varias relaciones de aspecto habituales; al seleccionar custom se pueden definir anchura y altura de 256 a 1440 píxeles, alineadas a múltiplos de 32.
Formato y calidad de salida: permite salida en webp, jpg o png y ajustar la calidad de salida de 0 a 100; la salida en png no se ve afectada por el parámetro de calidad.
Generación reproducible y ajuste de detalles: un seed fijo reproduce los resultados, prompt_upsampling puede reescribir automáticamente las indicaciones y safety_tolerance permite ajustar el margen de relajación del contenido.
Casos de uso
- Generación masiva de material de marketing y publicidad: los equipos de operaciones y marketing introducen el texto de la campaña y producen imágenes promocionales en varios formatos para canales de difusión y landing pages.
- Imágenes de escena para visualización de productos: los equipos de comercio electrónico usan descripciones de producto o imágenes de referencia como entrada para generar escenas de producto destinadas a páginas de detalle y materiales de exhibición.
- Producción de ilustraciones para creadores de contenido: los creadores introducen indicaciones según el tema del artículo y producen ilustraciones con un estilo coherente para contenido gráfico y publicación en redes sociales.
- Presentación visual de prototipos de diseño: los diseñadores usan descripciones conceptuales o imágenes de referencia como entrada para producir rápidamente borradores visuales destinados a la comunicación de propuestas y la confirmación de la dirección del prototipo.
- Nodo de generación de imágenes en flujos de trabajo automatizados: los equipos de ingeniería integran la interfaz en la canalización y producen imágenes de forma estable con parámetros y seed fijos para la producción de contenido a escala.
Limitaciones y recomendaciones de selección
Solo genera imágenes estáticas; no admite vídeo ni otras modalidades. El resultado depende de la calidad de las indicaciones, y las necesidades complejas o específicas requieren varias rondas de ajuste. El límite de anchura y altura es de 1440 píxeles; los tamaños custom se alinean a múltiplos de 32 píxeles, por lo que las necesidades de tamaños superiores deben tratarse por otra vía. La calidad de salida se ajusta principalmente en webp/jpg; con png el parámetro de calidad no surte efecto. Reducir la tolerancia de seguridad puede afectar la tasa de aprobación de las imágenes. Si la tarea requiere generación de vídeo o un control por lotes que vaya más allá de una sola imagen, debe recurrirse a un modelo de la modalidad correspondiente.
Preguntas frecuentes
Ver todas las preguntas →-
¿Para qué tareas es principalmente adecuado FLUX1.1 [pro]?
Es adecuado para fotografía realista, arquitectura, gastronomía, naturaleza y visuales comerciales; admite tamaños personalizados y control mejorado de Prompt.
-
¿FLUX1.1 [pro] admite imágenes de referencia?
La ruta actual es de generación de imágenes puramente a partir de texto y no acepta imágenes de referencia.
-
¿Qué especificaciones de salida se admiten?
La página actual muestra Custom width / height y Custom, 1:1, 16:9, 9:16; las opciones finales dependen de los parámetros de Playground.
-
¿Cómo se factura FLUX1.1 [pro]?
Se factura por el número de imágenes generadas con éxito; si hay diferencias según la resolución o el nivel de calidad, se mostrarán en el precio en tiempo real de la página.
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-1.1-pro
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para flux-1.1-pro y la ruta default; consulta la tabla de parámetros a continuación.
seedintegerOpcionalSemilla aleatoria para generar resultados reproducibles; la misma semilla junto con los demás parámetros idénticos permite reproducir la misma generación.
widthintegerOpcionalmin 256max 1440Ancho de imagen personalizado; solo se usa cuando aspect_ratio es custom; el valor se redondea al múltiplo de 32 más cercano.
heightintegerOpcionalmin 256max 1440Alto de imagen personalizado; solo se usa cuando aspect_ratio es custom; el valor se redondea al múltiplo de 32 más cercano.
promptstringObligatorioPrompt de texto utilizado para la generación de la imagen.
aspect_ratiostringOpcionalPredeterminado: "1:1"Relación de aspecto de la imagen generada; por defecto 1:1.
custom1:116:93:22:34:55:49:16Mostrar todo (2)
3:44:3image_promptstringOpcionalURL opcional de imagen de referencia; el formato debe ser jpeg, png, gif o webp.
output_formatstringOpcionalPredeterminado: "webp"Formato de la imagen de salida; por defecto webp.
webpjpgpngoutput_qualityintegerOpcionalPredeterminado: 80min 0max 100Calidad al guardar la imagen de salida; valor entero de 0 a 100, por defecto 80; no tiene efecto en salidas png.
safety_toleranceintegerOpcionalPredeterminado: 2min 1max 6Tolerancia de seguridad; rango de 1 a 6, donde 1 es la más estricta y 6 la más permisiva; por defecto 2.
prompt_upsamplingbooleanOpcionalPredeterminado: falseIndica si se debe reescribir automáticamente el prompt para aumentar la creatividad de la generación; por defecto false.
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-1.1-pro",
"input": {
"prompt": "…",
"aspect_ratio": "1:1",
"output_format": "webp",
"output_quality": 80,
"safety_tolerance": 2,
"prompt_upsampling": false
}
}' 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-1.1-pro",
input: {
"prompt": "…",
"aspect_ratio": "1:1",
"output_format": "webp",
"output_quality": 80,
"safety_tolerance": 2,
"prompt_upsampling": false
}
}),
});
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-1.1-pro",
"input": {
"prompt": "…",
"aspect_ratio": "1:1",
"output_format": "webp",
"output_quality": 80,
"safety_tolerance": 2,
"prompt_upsampling": False
}
},
)
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
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
Comparativa
Recraft v4.1 Flash comparativa horizontal de texto a imagen: guía de selección y migración para desarrolladores
Con un coste de $0.01 por imagen y capacidad pura de texto a imagen, evalúa si encaja en tu pipeline de generación de imágenes
-
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
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 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 kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
Comparativa
hailuo-2.3-fast/image-to-video comparativa horizontal: cómo elegir un modelo de imagen a video y puntos clave para migrar
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
FLUX.2 Black Forest Labs $0.035 /imagen -
Qwen Image 2.1 Alibaba $0.020 /imagen -
Muse Image 1.0 Meta $0.015 per task -
Seedream 4.5 ByteDance $0.045 /imagen -
Nano Banana Pro Google $0.057 /imagen -
Qwen Image 2.0 Alibaba $0.042 /imagen -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /imagen -
FLUX 3 Image Black Forest Labs $0.041 /imagen -
Recraft Crisp Upscale Recraft $0.004 /imagen -
Z-Image Alibaba $0.008 /imagen -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /imagen -
GPT Image 2 OpenAI $0.007 /imagen
Mismo proveedor
-
FLUX.2 Klein 4B Black Forest Labs $0.0004 /imagen -
FLUX.1 Schnell Black Forest Labs $0.005 /imagen -
FLUX 3 Max Black Forest Labs $0.061 /segundo -
FLUX 3 Image Black Forest Labs $0.041 /imagen -
FLUX 3 Video Black Forest Labs $0.090 /segundo -
FLUX.2 Black Forest Labs $0.035 /imagen -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /imagen -
FLUX.1 Kontext Max Black Forest Labs $0.071 /imagen -
FLUX.1 Fill Pro Black Forest Labs $0.071 /imagen










