Introducción
FLUX.2 [flex] Edición ejecuta FLUX.2 [flex] de Black Forest Labs sobre imágenes que ya tienes. Toma de una a tres fuentes y una instrucción, como otra luz, una escena nueva o texto añadido, y devuelve un resultado en 1k con la forma de la fuente o una de nueve formas.
Elige un modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | FLUX.2 [flex] Texto a imagen |
| imágenes para cambiar o combinar | FLUX.2 [flex] Edición |
Funciones y aspectos destacados
Cambio de luz conservando al sujeto
En nuestra prueba, un retrato de día se convirtió en una noche lluviosa con piedras mojadas, luz de escaparate y gotas de lluvia, mientras la mujer, su abrigo y su pose se mantuvieron.
Composición con varias fuentes
Llama a cada fuente por su número e indica cómo se combinan. Nuestra prueba del perfume colocó un frasco de una foto sobre una repisa de mármol de otra e igualó la luz y el reflejo.
Texto añadido sobre el resultado
Pon entre comillas cualquier titular o etiqueta que quieras añadir. Nuestra composición volvió con el titular escrito tal como se pidió; un “No.” en una etiqueta puede volver como el signo de número.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5000 caracteres. Indica qué cambiar y qué debe quedar igual, y llama a cada fuente por su posición, como imagen 1 e imagen 2. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | De 1 a 3 imágenes de origen, en el orden en que tu prompt las menciona. El precio es el mismo sin importar el número de fuentes. mínimo 1 elementos · máximo 3 elementos |
aspect_ratio | No | auto (por defecto) conserva más o menos el tamaño y la forma de la primera fuente; o elige una de nueve formas, de 21:9 a 9:21. La forma no cambia el precio. |
resolution | No | Para la edición solo hay 1k. Se aplica cuando eliges una relación de aspecto fija; con auto el resultado sigue el tamaño de la primera fuente. |
seed | No | Número entero opcional de 0 a 2147483647. Reutilízalo con el mismo prompt y las mismas fuentes para comparar variaciones lado a lado. |
Precios
$0.115 / imagen
Se factura por imagen con un solo precio fijo: ni el número de imágenes de origen ni la relación de aspecto lo cambian. Las solicitudes rechazadas o fallidas no se cobran.
Casos de uso
Escenas de producto
Llevar la foto de un producto a un entorno estilizado y añadir una etiqueta o un titular.
Variaciones de ambiente y de clima
Muestra un retrato al atardecer, bajo la lluvia o bajo neón, a un cliente que está eligiendo una dirección.
Paisajes e imágenes cotidianas
Cambia la hora del día, la estación o el fondo de un paisaje o una escena de calle.
Guía de prompts y consejos prácticos
Indica qué se queda
Después del cambio, enumera el rostro, el atuendo y la pose que deben permanecer igual.
Numera tus fuentes
Escribe imagen 1 e imagen 2 en el prompt para que cada fuente tenga una función clara.
Limítate a material apto para todo público
La edición rechaza retratos mucho más fácilmente que texto a imagen, incluso en el nivel Suave, así que úsala para productos, paisajes y retratos cotidianos.
Elige auto para conservar el encuadre
Con auto, el resultado sigue el tamaño de tu primera fuente. Elige una forma fija solo cuando quieras reencuadrar.
Calcula de uno a dos minutos
Las ediciones tardaron entre 45 y 120 segundos en nuestras pruebas.
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-flex/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.

























