Introducción
FLUX.1 Kontext [max] Edición cambia el estilo o modifica una foto a partir de una instrucción escrita usando el modelo Kontext premium de Black Forest Labs, lanzado el 29 de mayo de 2025. Es el nivel indicado cuando la edición abarca todo el cuadro, como una nueva época, otra hora del día u otra estación, y aun así necesitas que las personas y el texto lleguen intactos.
Modo adecuado para tu material
| Lo que tienes | Modo |
|---|---|
| una foto terminada para cambiar de estilo | FLUX.1 Kontext [max] Edición |
| una escena escrita sin imagen todavía | FLUX.1 Kontext [max] Texto a imagen |
Funciones y aspectos destacados
Cambios de estilo en todo el cuadro sin cambiar el reparto
Nuestra pareja de la azotea se convirtió en un fotograma de cine negro en blanco y negro de los años cincuenta, con luz principal dura. Los dos rostros, el abrazo y la silueta del vestido se conservaron; el letrero siguió legible, un poco recortado por el nuevo encuadre.
Cambios de hora y de estación
La cabina del tren nocturno pasó a un amanecer sobre montañas nevadas, la bata roja se volvió seda marfil y la copa de vino una taza de café, mientras el rostro de la mujer y su pose con las piernas recogidas se mantenían.
Varios cambios en una instrucción
En la edición de la cabina, Kontext [max] resolvió tres cambios a la vez, luz, prenda y objeto, sin alterar lo demás.
El formato sigue a la fuente
En auto el resultado conserva el encuadre de la fuente: la azotea 16:9 volvió en 1328x752 y la cabina 3:4 en 864x1152.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, hasta 5,000 caracteres. Indica primero el nuevo look o los cambios y después los anclajes: rostros, pose, corte de la ropa y cualquier texto que deba quedarse. mínimo 1 caracteres · máximo 5000 caracteres |
image_url | Sí | Obligatorio. La foto que Kontext [max] va a editar: JPEG, PNG o WebP de hasta 10 MB. mínimo 1 caracteres |
aspect_ratio | No | auto (predeterminado) sigue a la foto de origen. Elige 1:1, 16:9, 9:16, 4:3, 3:4 o 21:9 para reencuadrar; el precio no cambia. |
output_format | No | jpeg (predeterminado) o png, sin diferencia de precio. |
enable_prompt_expansion | No | Desactivado por defecto. Valor predeterminado: |
Precios
$0.056 / imagen
Cada edición de Kontext [max] se cobra por imagen con la misma tarifa fija que el texto a imagen. Las solicitudes rechazadas o fallidas no tienen costo.
Casos de uso
Looks de época y de género
Cine negro, película a color de los setenta, revista brillante: una foto rehecha en otra época para una campaña o un moodboard.
Continuidad a lo largo del día
Versiones de mañana, hora dorada y noche de la misma escena con las mismas personas.
Cambios de vestuario y objetos en imágenes terminadas
Cambia una bata, una copa, un bolso o un sombrero en una imagen que ya te gusta.
Rescatar una imagen casi lista
Corrige lo único que falla en una imagen buena en lugar de generar otra.
Guía de prompts y consejos prácticos
Primero el look, después los anclajes
"Convierte esta foto en un fotograma de cine negro de los años cincuenta en blanco y negro" y luego "mantén los dos rostros, su pose y el letrero tal como están".
Agrupa los cambios relacionados
Luz, prenda y objeto pueden compartir instrucción cuando describen un mismo momento nuevo, como un amanecer con bata marfil y café.
Menciona el texto que quieres conservar
Nombra el letrero o la etiqueta por sus palabras para que la edición lo trate como algo que debe preservar.
Recorta a propósito
Elige una relación solo cuando quieras un cuadro nuevo; si no, auto evita recortes inesperados.
Compara los rostros después de un gran cambio de estilo
Los cambios de época y de luz son la prueba más difícil para la identidad. Pon el resultado junto a la fuente; si un rostro se aleja, repite el cambio nombrando el rostro primero en la lista de lo que debe quedarse.
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-1-kontext-max/edit",
"input": {
"aspect_ratio": "auto",
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.


























