Introducción
FLUX.2 Dev Edición de imagen modifica o combina hasta tres imágenes de origen con FLUX.2 [dev] de Black Forest Labs, un modelo de pesos abiertos de 32 mil millones de parámetros. Describe el nuevo atuendo, escenario o luz, indica qué debe quedar igual y recibe una imagen. Mantiene los rostros cerca de las fuentes, puede colocar en una escena a personas de fotos distintas y no aplica ningún filtro a las fuentes, al prompt ni al resultado.
Elige un modo según tu punto de partida
| Lo que tienes | Modo |
|---|---|
| de una a tres imágenes para modificar o combinar | FLUX.2 Dev Edición de imagen |
| solo un brief escrito | FLUX.2 Dev Texto a imagen |
Funciones y aspectos destacados
Hasta tres referencias
Enumera las imágenes en el orden en que las menciona tu prompt y nómbralas como imagen 1, imagen 2 e imagen 3. En nuestra prueba, una mujer de un retrato y un hombre de otro bailaron juntos en una escena nueva, con ambos rostros aún cerca de sus fotos.
Un encuadre que sigue a la fuente
Con la forma en auto, el resultado conserva las proporciones de la primera imagen a alrededor de un megapíxel. Elige una relación de aspecto y 2k cuando quieras otro recorte o más píxeles.
Un solo precio
El precio por imagen es el mismo con una, dos o tres fuentes y en 1k o en 2k.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5.000 caracteres. Di qué debe cambiar y qué tiene que quedar igual. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | De una a tres imágenes de origen, de hasta 10 MB cada una, en el orden en que tu prompt las menciona (“imagen 1”, “imagen 2”). mínimo 1 elementos · máximo 3 elementos |
aspect_ratio | No | auto (predeterminado) sigue la forma de la primera imagen de origen a alrededor de un megapíxel. Elige una de las nueve relaciones de 21:9 a 9:21 para recortar de otra manera. |
resolution | No | 1k (predeterminado) o 2k, solo se aplica cuando eliges una relación de aspecto concreta. Con auto, el resultado se queda en alrededor de un megapíxel. |
seed | No | Un número entero de 0 a 2147483647. Mantenlo fijo mientras ajustas el prompt para comparar los resultados con facilidad; no garantiza una imagen idéntica. |
Precios
$0.023 / imagen
Se factura por imagen a un precio único, sin importar el número de imágenes de origen ni el nivel de tamaño. Las solicitudes fallidas no se cobran.
Casos de uso
Nuevo atuendo y escenario para la misma persona
Lleva a una persona de una oficina a un bar o de una calle a una playa, con otro atuendo y otra luz, mientras el rostro se mantiene.
Dos personas en una misma escena
Lleva a personas de retratos distintos a un solo encuadre para una foto de pareja o un dúo de personajes.
Cambios de luz y de color
Pide una nueva fuente de luz con un color hex y conserva el resto de la composición.
Guía de prompts y consejos prácticos
Di qué se queda igual
Empieza con “el mismo hombre, el mismo rostro y la misma barba” y luego enumera qué cambia. Las listas cortas y explícitas funcionan mejor que las descripciones largas.
Numera a tus personas
Al combinar fotos, escribe “la mujer de la imagen 1 y el hombre de la imagen 2” y pide conservar ambos rostros exactamente como en las fotos.
Una persona por encuadre cuando importe
Añade “solo en el encuadre, sin otras personas” para evitar que aparezcan figuras de más en el fondo.
Empieza con auto
Deja primero la forma en auto. Elige una relación de aspecto y 2k cuando te guste el contenido, y conserva la seed para comparar la versión más grande.
Usa fuentes nítidas
Las fotos bien iluminadas y de frente conservan mejor los rostros. La segunda y la tercera persona son algo menos estables que la primera.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-2-dev/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
























