Introducción
FLUX.2 [klein] 9B Edición es el modo de edición del modelo de imagen pequeño y rápido de Black Forest Labs, publicado el 15 de enero de 2026. Acepta de una a tres imágenes de origen y una instrucción, devuelve un JPEG a alrededor de un megapíxel o en el nivel 1k o 2k que elijas, y no tiene filtro de contenido.
Elige un modo según tu punto de partida
| Lo que tienes | Modo |
|---|---|
| un brief escrito | FLUX.2 Klein 9B Texto a imagen |
| imágenes para modificar | FLUX.2 Klein 9B Edición |
Funciones y aspectos destacados
La misma persona, un look nuevo
En nuestras pruebas, el rostro, el cabello y la pose se conservaron a través de cambios de atuendo y de fondo. Enumera lo que debe quedar igual y luego describe el cambio.
Cambia el tamaño mientras editas
Elige una forma y un nivel de tamaño, y la edición vuelve a 2048 píxeles en el lado largo. Con auto conserva la forma de la fuente.
Un solo precio
Una edición cuesta lo mismo con una fuente o con tres, en 1k o en 2k.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, hasta 5.000 caracteres. Di qué debe cambiar y qué tiene que quedar igual, por ejemplo la cara, el pelo y la pose, y nombra las prendas nuevas. 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, en el orden en que tu prompt las menciona. El número de imágenes no cambia el precio. mínimo 1 elementos · máximo 3 elementos |
aspect_ratio | No | auto (predeterminado) conserva la forma de la primera imagen de origen a alrededor 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 (predeterminado) o 2k, solo se aplica cuando eliges una relación de aspecto; con auto el resultado se queda en alrededor de un megapíxel. No cambia el precio. |
seed | No | Número entero opcional de 0 a 2147483647. Reutilízalo para comparar lado a lado los cambios en el prompt; déjalo vacío para usar uno aleatorio. |
Precios
$0.016 / imagen
Un precio único por imagen, sin importar el número de imágenes de origen ni si el tamaño es 1k o 2k. Las solicitudes fallidas o rechazadas no se cobran.
Casos de uso
Cambios de atuendo y de escena
Cambia la ropa, el lugar o la hora del día mientras las personas siguen siendo reconocibles.
Variaciones rápidas de una foto
Varios ambientes de una misma imagen en lo que dura un café.
Combinar hasta tres fuentes
Una persona, un lugar y un objeto reunidos en un solo encuadre, cada uno nombrado en el prompt.
Guía de prompts y consejos prácticos
Nombra lo que se queda
Rostro, cabello, pose, asiento. Luego describe el cambio en una o dos frases.
Nombra las prendas nuevas
Indica el corte y la tela que quieres; en nuestras pruebas la edición siguió las prendas nombradas en el prompt.
Cambia una cosa a la vez
Para transformaciones mayores, encadena dos ediciones.
Elige una forma para 2k
Auto da alrededor de un megapíxel; elige una forma si quieres el nivel 2k.
Revisa manos y rostros
Los modelos pequeños pueden fallar en ambos. Prueba otra seed si alguno falla.
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-klein-9b/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.
























