Introducción
FLUX.2 [pro] Edición ejecuta FLUX.2 [pro] de Black Forest Labs sobre imágenes que ya tienes. Acepta de una a tres fuentes, aplica el cambio que describes y devuelve 1k o 2k 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 [pro] Texto a imagen |
| de una a tres imágenes para cambiar o combinar | FLUX.2 [pro] Edición |
Funciones y aspectos destacados
Composiciones con varias referencias
Combina una persona, un producto y un lugar de fotos separadas. En nuestro anuncio de audífonos, el rostro, el cabello y el cárdigan, y el diseño de los audífonos, se mantuvieron como en las fuentes.
Cambios de escena y de luz
Cambia el escenario o vuelve a iluminar una foto mientras el sujeto se queda en su lugar. Nuestra calle soleada se convirtió en una noche lluviosa de neón con gotas de lluvia sobre el blazer.
Texto añadido en la edición
Añade un titular a la imagen en el mismo paso. El nuestro salió escrito tal como lo pusimos entre comillas.
Precio fijo por imagen
Una fuente o tres, 1k o 2k, una edición cuesta lo mismo.
Estricto con las personas
En nuestras pruebas se rechazaron fuentes de retrato incluso para un cambio de atuendo de nivel Suave. Las solicitudes rechazadas no se cobran.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, hasta 5000 caracteres. Indica qué cambiar y qué debe quedar igual, y llama a las fuentes imagen 1, imagen 2 e imagen 3 según el orden de subida. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | Obligatorio, de una a tres imágenes de origen, de hasta 10 MB cada una. Súbelas en el orden en que tu prompt las menciona. mínimo 1 elementos · máximo 3 elementos |
aspect_ratio | No | auto (por defecto) conserva la forma de la primera imagen de origen con cerca de un megapíxel; o elige una de nueve formas, de 21:9 a 9:21. La forma no cambia el precio. |
resolution | No | 1k (por defecto) o 2k. Solo se aplica cuando eliges una forma; con auto el resultado se mantiene en cerca de un megapíxel. |
seed | No | Número entero opcional de 0 a 2147483647. Reutilízalo mientras cambias el prompt para comparar variaciones; no garantiza una imagen idéntica. |
Precios
$0.058 / imagen
Se factura con un precio fijo por imagen, sin importar el número de fuentes ni el nivel de tamaño. Las solicitudes rechazadas o fallidas no se cobran.
Casos de uso
Anuncios a partir de recursos separados
Reúne la foto de una modelo, la imagen de un producto y un lugar en un solo visual.
Variaciones de ambiente
Muestra la misma escena de día, de noche o bajo la lluvia para un cliente que debe elegir una dirección.
Rediseño de productos y lugares
Cambia el fondo, la luz o el estilo de un producto, una habitación o un retrato.
Guía de prompts y consejos prácticos
Numera las fuentes
Indica que la imagen 1 es la persona, la imagen 2 el producto y la imagen 3 el lugar, en el orden de subida.
Nombra lo que debe quedar igual
Después del cambio, enumera el rostro, el atuendo, la pose o el diseño que debe permanecer exactamente como estaba.
Cambia una cosa a la vez
Un solo cambio claro mantiene estable el resto del encuadre; encadena ediciones en lugar de meter varias en una.
Dale tiempo
Las ediciones tardaron entre 45 y 120 segundos en nuestras pruebas.
Mantenlo apto para el trabajo
Este modelo es estricto con las personas, así que úsalo para productos, lugares y retratos aptos para el trabajo.
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-pro/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.
























