Introducción
FLUX.2 [max] Edición ejecuta el modelo de mayor calidad de FLUX.2 de Black Forest Labs sobre fotos que ya tienes. Toma de una a tres fuentes y una instrucción, y devuelve una imagen con la forma de la primera fuente o en una de nueve relaciones de aspecto, en 1k o 2k.
Elige un modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | FLUX.2 Max Texto a imagen |
| de una a tres fotos para cambiar o combinar | FLUX.2 Max Edición |
Funciones y aspectos destacados
Hasta tres referencias
Combina personas y lugares de fotos separadas en una sola solicitud. En nuestra prueba de la librería, dos retratos y un espacio se convirtieron en una sola escena, con cada rostro, peinado y atuendo conservado y la luz de lámpara del lugar sobre ambas mujeres.
Cambios de fondo y de luz
Cambia un fondo de estudio por un puerto en la hora dorada y vuelve a iluminar al sujeto, con el rostro, la barba, la expresión y la ropa sin cambios.
Un precio por edición
Una edición se factura por imagen con un solo precio, sin importar el número de fuentes ni el nivel de tamaño. Las solicitudes rechazadas no se cobran.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Hasta 5000 caracteres. Indica qué cambiar y qué debe quedar igual. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | De 1 a 3 imágenes de origen, de hasta 10 MB cada una. Indica en el prompt qué aporta cada una: una persona, un espacio, un producto. 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 cuando eliges una relación de aspecto; con auto el resultado se mantiene en cerca de un megapíxel. |
seed | No | Número entero opcional de 0 a 2147483647. Reutilízalo con el mismo prompt y las mismas fuentes para comparar los cambios con más facilidad; no garantiza una imagen idéntica. |
Precios
$0.076 / imagen
Se factura por imagen con un solo precio por edición, sin importar el número de imágenes de origen ni el nivel de tamaño. Las solicitudes fallidas o rechazadas no se cobran.
Casos de uso
Fotografía de productos y lugares
Fondos nuevos, luz nueva y escenas coherentes para imágenes de catálogo y de campaña.
Retoque de retratos cotidianos
Cambia el escenario, la luz o el estilo de un retrato cotidiano sin dejar de reconocer a la persona.
Escenas de grupo a partir de fotos separadas
Lleva a personas de retratos individuales a un mismo espacio o lugar.
Guía de prompts y consejos prácticos
Indica qué debe quedar igual
Después del cambio, enumera los rostros, el cabello, la ropa y la pose que no deben moverse.
Numera tus fuentes
Llámalas imagen 1, imagen 2 e imagen 3 en el orden en que las subiste, y dale una función a cada una.
Usa fotos de origen limpias y cotidianas
Las ediciones se filtran con rigor: en nuestras pruebas, Max rechazó ediciones de retratos incluso en el nivel Suave. Los productos, los lugares y los retratos con ropa sencilla son el material seguro.
Elige auto para conservar el encuadre
Auto conserva la forma de la primera fuente; escoge una relación y un nivel cuando quieras otro recorte o 2k.
Calcula hasta dos minutos
Nuestras ediciones tardaron entre 45 y 120 segundos.
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-max/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.
