Introducción
FLUX.1 Kontext [pro] Edición recibe una foto y una instrucción escrita y devuelve la misma foto con la instrucción aplicada. Black Forest Labs presentó Kontext el 29 de mayo de 2025 como un modelo que edita en contexto: lee la imagen que envías en lugar de redibujar la escena desde cero, así que rostros, poses, habitaciones y letreros sobreviven a cambios que obligarían a un modelo de texto a imagen a empezar de nuevo.
Qué modo usar según lo que tengas
| Lo que tienes | Modo |
|---|---|
| una foto que quieres cambiar | FLUX.1 Kontext [pro] Edición |
| solo una escena escrita | FLUX.1 Kontext [pro] Texto a imagen |
Funciones y aspectos destacados
Cambios locales, el resto intacto
En nuestra prueba del tocador cambiamos un camisón de satén champán por encaje negro. El rostro, el cabello, las bombillas y el texto de labial en el espejo se quedaron donde estaban.
Clima, hora y luz en el mismo cuadro
La alberca del motel pasó del atardecer a una noche lluviosa: lluvia sobre el agua, el neón reflejado en los azulejos mojados y la camisa empapada, con el rostro y la pose del hombre sin cambios.
Letreros y textos sobreviven a la edición
El texto que ya está en la foto se conserva salvo que pidas cambiarlo, y puedes agregar texto nuevo entre comillas.
Mantén tu formato o define uno nuevo
Con la relación de aspecto en auto, el resultado sigue a la fuente: una foto de 1344x768 volvió en 1328x752 y una cuadrada en 992x992. Elige una relación para recortar o ampliar.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, hasta 5,000 caracteres. Empieza por el cambio y luego nombra lo que debe quedarse: rostro, cabello, pose, fondo, texto existente. mínimo 1 caracteres · máximo 5000 caracteres |
image_url | Sí | Obligatorio. Una foto JPEG, PNG o WebP de hasta 10 MB. mínimo 1 caracteres |
aspect_ratio | No | auto (predeterminado) conserva el formato de la foto de origen. Elige 1:1, 16:9, 9:16, 4:3, 3:4 o 21:9 para recortar o ampliar el cuadro. |
output_format | No | jpeg (predeterminado) o png. El formato no cambia el precio. |
enable_prompt_expansion | No | Desactivado por defecto. Al activarlo, la instrucción se amplía con detalles antes de editar; déjalo apagado cuando la redacción de la edición deba respetarse al pie de la letra. Valor predeterminado: |
Precios
$0.028 / imagen
Las ediciones de Kontext [pro] se cobran por imagen, igual que texto a imagen, sin importar el tamaño o la forma de la fuente. No pagas nada por una solicitud que se rechaza o que falla.
Casos de uso
Pruebas de vestuario y estilismo
Un retrato, varios looks: satén, encaje, blazer, bata, cada uno como edición propia de la misma fuente.
Variantes de ambiente e iluminación
Del día a la noche, de seco a lluvia, de cálido a frío, sin perder a la persona del cuadro.
Continuidad para una serie
Vuelve a enviar cada resultado como la siguiente fuente para llevar a un personaje por una secuencia de cambios pequeños y controlados.
Corregir un detalle
Cambiar el texto de un letrero, quitar un objeto o recolorear una prenda.
Guía de prompts y consejos prácticos
Primero el cambio, luego los anclajes
Primero "Cambia su camisón por encaje negro" y después "Mantén exactamente igual su rostro, cabello, pose y el texto del espejo".
Nombra las cosas por su aspecto
Escribe "el camisón de satén champán" en vez de "su ropa"; el modelo encuentra la zona por tu descripción.
Un cambio por pasada
Varias ediciones pequeñas seguidas conservan mejor la identidad que una instrucción larga que lo reescribe todo.
Usa auto para el formato original
Fija una relación solo cuando quieras recortar o ampliar el cuadro.
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-pro/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.


























