Black Forest Labs

FLUX.2

flux-2/text-to-image

La familia de generación y edición de imágenes de Black Forest Labs, que admite transferencia de estilo basada en imágenes de referencia y fusión de múltiples imágenes de referencia, conservando en la medida de lo posible la composición original y la posición del sujeto durante la edición

flux-2/image-to-image flux-2/text-to-image

Probar flux-2/text-to-image

Entrada

Creaciones

Ver todas las creaciones

Salida

image

Rellena los parámetros y genera: los resultados aparecerán aquí.

Precios

flux-2/text-to-image per image

Especificaciones	Precio unitario
0.5 MP	$0.0375
1 MP	$0.050
2 MP	$0.075
4 MP	$0.125

Descripción general

FLUX.2 texto a imagen es la vía de generación puramente textual del modelo de generación de imágenes lanzado por Black Forest Labs, que se invoca a través de la interfaz unificada de HiAPI.ai. Recibe un mensaje de texto de indicación y produce imágenes de estilo realista, y expone controles de parámetros como resolución, relación de aspecto, formato y calidad de salida y semilla aleatoria, adecuados para la exploración de conceptos creativos y la producción visual por lotes que requieren resultados estables y reproducibles.

Aspectos clave

Resolución y relación de aspecto configurables según necesidad: admite resoluciones de salida de 0,5 a 4 MP y varias relaciones de aspecto habituales, además de anchura y altura personalizadas, para elegir la nitidez y la composición según el uso.
Generación reproducible mediante semilla aleatoria: basta con establecer seed para repetir el mismo resultado, lo que facilita la comparación de parámetros y la regresión de versiones sobre una misma composición.
Parámetros de entrega de salida controlables: permite elegir formato webp, jpg o png y ajustar la calidad de compresión, produciendo directamente archivos de imagen listos para distribuir.
Tolerancia de seguridad ajustable: safety_tolerance ofrece un intervalo de 1 a 5, de modo que se puede ajustar el rigor del filtrado según los requisitos de cumplimiento del negocio.

Descripción de capacidades

Generación de imágenes realistas a partir de texto: basta con introducir un mensaje de texto de indicación para generar una imagen, y tanto las fuentes oficiales como las de terceros sitúan el estilo realista como enfoque principal, utilizable para visuales conceptuales y producción de material.

Control de relación de aspecto y resolución: mediante aspect_ratio se elige una proporción predefinida o una anchura y altura personalizadas, y junto con el parámetro de resolución de 0,5 a 4 MP se ajusta a composiciones horizontales o verticales y a distintos espacios de visualización.

Ajuste de formato y calidad de salida: admite tres formatos de salida (webp, jpg y png) y permite establecer una calidad de guardado de 0 a 100 para equilibrar el tamaño del archivo y la calidad de imagen según el uso del producto.

Generación reproducible: tras especificar seed, la misma combinación de mensaje de indicación y parámetros produce resultados idénticos, lo que facilita localizar el origen de los cambios durante la iteración.

Ajuste del filtrado de seguridad: el parámetro safety_tolerance ofrece cinco niveles, del más estricto al más permisivo, configurable según el criterio de cumplimiento del escenario de despliegue.

Casos de uso

Equipos creativos que elaboran bocetos conceptuales: producir rápidamente varias versiones de borradores visuales con indicaciones breves para filtrar direcciones y realizar revisiones internas antes de decidir qué detallar.
Exploración de composición en diseño y publicidad: generar imágenes en versión horizontal y vertical combinando los parámetros de relación de aspecto y resolución, para usarlas directamente en propuestas y previsualizaciones de maquetación.
Flujos de producción de material por lotes: generar por lotes activos de imagen con especificaciones uniformes en flujos automatizados mediante semillas fijas y parámetros de formato de salida.
Referencia visual de estilo realista: generar escenas realistas o imágenes de ambiente de producto como material de referencia antes de la fotografía, el montaje de escenarios o el renderizado.

Limitaciones y recomendaciones de selección

Esta vía solo acepta mensajes de texto de indicación y no procesa imágenes de referencia; cuando se requiera editar o transferir el estilo a partir de una imagen existente, debe usarse la vía de imagen a imagen de la misma familia. La resolución llega hasta 4 MP, pero la descripción de parámetros recomienda 2 MP o menos; para salidas de gran tamaño debe evaluarse por cuenta propia la ganancia en calidad. El filtrado de seguridad se aplica por niveles, y los niveles más estrictos pueden afectar la visibilidad del contenido generado. La licencia no comercial y los requisitos de despliegue en hardware mencionados en los materiales de investigación dependen de la vía real de obtención del modelo por parte del usuario; al invocar mediante HiAPI.ai pueden ignorarse este tipo de restricciones de autodespliegue.

Novedades

Ver el registro de cambios →

Nuevo modelo Nuevo modelo: flux-2-klein-4b/text-to-image, generación de imágenes a partir de texto de alta relación calidad-precio con escalas de 0.25-4 MP; con… Jul 27, 2026
Nuevo modelo Nuevo modelo de edición de imágenes: flux-2-klein-4b/image-to-image admite una sola imagen de referencia y salida en tramos de 0.25-4 MP… Jul 27, 2026

Preguntas frecuentes

Ver todas las preguntas →

¿Cuántas imágenes de referencia admite la edición de imágenes de FLUX.2?

Admite de 1 a 8 imágenes de referencia en formato JPEG, PNG o WebP, de no más de 10MB cada una. Al combinar varias imágenes, se debe indicar en el Prompt el rol de cada imagen en orden.
¿Para qué sirve la relación de aspecto auto?

auto sigue la relación de aspecto de la primera imagen de referencia; cuando se necesita una salida fija horizontal, vertical o cuadrada, se puede elegir una relación de aspecto explícita.
¿Cómo se factura 1K y 2K?

1K y 2K usan diferentes tarifas por imagen, y la cantidad de imágenes de referencia no tiene un cargo adicional; el monto específico se rige por el precio en tiempo real de esta página.
¿Cómo reducir la deriva del sujeto y el logo?

Indica explícitamente el propósito de cada imagen de referencia y enumera a la vez el sujeto, el texto, los materiales, la posición y la iluminación que deben modificarse y los que deben conservarse obligatoriamente.

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

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para flux-2/text-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; establecer la misma semilla permite obtener una salida de generación repetible.

widthintegerOpcionalmin 256max 2048

Ancho de imagen personalizado; solo tiene efecto cuando aspect_ratio es custom, y se redondea automáticamente al múltiplo de 16 más cercano.

heightintegerOpcionalmin 256max 2048

Alto de imagen personalizado; solo tiene efecto cuando aspect_ratio es custom, y se redondea automáticamente al múltiplo de 16 más cercano.

promptstringObligatorio

Indicación de texto para la generación de imágenes que describe el contenido visual deseado.

resolutionstringOpcionalPredeterminado: "1 MP"

Resolución en megapíxeles (MP) de la imagen de salida; admite hasta 4 MP, se recomienda usar 2 MP o menos. Valor predeterminado: 1 MP.

Opciones:0.5 MP1 MP2 MP4 MP

aspect_ratiostringOpcionalPredeterminado: "1:1"

Relación de aspecto de la imagen generada. Valor predeterminado: 1:1.

Opciones:1:116:93:22:34:55:49:163:4

Mostrar todo (2)

4:3custom

output_formatstringOpcionalPredeterminado: "webp"

Formato de guardado de la imagen de salida. Valor predeterminado: webp.

Opciones:webpjpgpng

output_qualityintegerOpcionalPredeterminado: 80min 0max 100

Calidad de guardado de la imagen de salida, con valores de 0 a 100; no es válido para el formato png. Valor predeterminado: 80.

safety_toleranceintegerOpcionalPredeterminado: 2min 1max 5

Tolerancia de seguridad: 1 es la más estricta y 5 la más permisiva. Valor predeterminado: 2.

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/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "1 MP",
    "aspect_ratio": "1:1",
    "output_format": "webp",
    "output_quality": 80,
    "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-2/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "1 MP",
      "aspect_ratio": "1:1",
      "output_format": "webp",
      "output_quality": 80,
      "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-2/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "1 MP",
          "aspect_ratio": "1:1",
          "output_format": "webp",
          "output_quality": 80,
          "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"
    }
  }
}