Black Forest Labs

FLUX.2

flux-2/image-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/image-to-image

Entrada

Creaciones

Ver todas las creaciones

Salida

image

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

Precios

flux-2/image-to-image per image

Especificaciones	Precio unitario
1K	$0.035
2K	$0.050

Descripción general

Línea de edición de imágenes FLUX.2, que recibe de 1 a 8 imágenes de referencia y una instrucción de edición, y realiza el reemplazo de estilo y los ajustes de detalle conservando en la medida de lo posible la composición y la posición del sujeto de la imagen original. Es adecuada para desarrolladores que necesitan transformar material existente en una nueva imagen visual, por ejemplo, transferencia de estilo, fusión de múltiples imágenes e iteración de prototipos creativos. Se invoca mediante la interfaz unificada de HiAPI.ai; la resolución de la imagen de salida puede ser 1K o 2K, y la relación de aspecto admite las proporciones habituales y el modo auto, que sigue la primera imagen.

Aspectos destacados

Prioriza conservar la composición y la posición del sujeto al editar: modifica el estilo y los detalles según la instrucción, en lugar de regenerar una imagen completamente distinta, lo que reduce el coste de alineación posterior.
Permite encadenar de 1 a 8 imágenes de referencia en una sola operación: en el prompt se pueden citar las imágenes en orden para sustituir materiales y fusionar elementos de varias imágenes.
Proporción y resolución de salida controlables: se puede especificar 1K o 2K y diversas relaciones de aspecto; el modo auto reutiliza directamente la composición de la primera imagen de entrada.

Capacidades

Edición de imágenes guiada por instrucciones: basta con pasar una imagen de referencia y una instrucción de edición para obtener la imagen modificada; es adecuada para hacer ajustes dirigidos sobre material existente, no para generar desde cero.

Referencia de múltiples imágenes y combinación de elementos: hasta 8 imágenes de entrada; en el prompt se puede hacer referencia a cada imagen por su número, lo que facilita colocar elementos de una imagen en la escena de otra.

Reutilización de composición y proporción: cuando la relación de aspecto se establece en auto, se ajusta a la primera imagen de entrada y mantiene el formato original mientras modifica el contenido, lo que facilita sustituir por lotes materiales del mismo tamaño.

Salida con resolución seleccionable: admite dos niveles de resolución de salida, 1K y 2K, que se eligen según las necesidades de visualización final, equilibrando el uso para vista previa y para producto final.

Casos de uso

Transferencia de estilo de fotos existentes por parte de diseñadores: se introduce la foto original y una descripción de estilo para obtener una versión estilizada que conserva la posición del sujeto, útil para moodboards y borradores de propuestas.
Sustitución de elementos en materiales de marketing: se introducen la imagen del producto y la imagen de la escena y se reemplaza el contenido de la imagen según la instrucción, generando anuncios de tamaño uniforme para su distribución multicanal.
Unificación de estilo con múltiples referencias: se introducen varias imágenes visuales existentes y se generan imágenes derivadas con un estilo coherente, útiles para ampliar una serie de imágenes de una campaña.

Limitaciones y recomendaciones de elección

Solo admite imagen a imagen; requiere al menos una imagen de referencia y no puede generar imágenes solo a partir de texto; el prompt está limitado a entre 3 y 5000 caracteres; las imágenes de entrada deben ser jpeg/png/webp y no superar los 10 MB cada una; no admite SVG. La resolución solo ofrece dos niveles, 1K y 2K. Cuando se necesite concebir una imagen desde cero, debe utilizarse la línea de texto a imagen de la misma familia; en escenarios que requieran licencia no comercial o despliegue local, deben verificarse por separado la autorización y las condiciones de despliegue.

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

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para flux-2/image-to-image y la ruta default; consulta la tabla de parámetros a continuación.

promptstringObligatoriominLength 3maxLength 5000

Instrucción de edición que describe el efecto de salida esperado, con una longitud de 3-5000 caracteres. Es necesario hacer referencia a las imágenes de entrada en orden, por ejemplo, «colocar el tarro de la imagen 1 dentro de la cápsula de la imagen 2».

image_urlsarrayObligatoriominItems 1maxItems 8

Matriz de imágenes de referencia de entrada, que contiene de 1 a 8 imágenes; cada una debe ser una URL de acceso público, en formato jpeg/png/webp, con un máximo de 10MB por imagen; no se admite SVG.

Array [ string ]

resolutionstringObligatorioPredeterminado: "1K"

Resolución de la imagen de salida; por defecto, 1K。

Opciones:1K2K

aspect_ratiostringObligatorioPredeterminado: "1:1"

Relación de aspecto de la imagen generada; por defecto, 1:1; si se establece en auto, se ajusta a la relación de aspecto de la primera imagen de entrada.

Opciones:1:14:33:416:99:163:22:3auto

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/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "1K",
    "aspect_ratio": "1:1"
  }
}'

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/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "1K",
      "aspect_ratio": "1:1"
    }
  }),
});
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/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "1K",
          "aspect_ratio": "1:1"
        }
    },
)
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"
    }
  }
}