Introducción
FLUX.2 [klein] 4B Edición de imagen modifica o combina hasta tres imágenes de origen con una instrucción escrita, con el modelo FLUX.2 más pequeño de Black Forest Labs, de código abierto bajo Apache 2.0. Conserva la forma de tu primera imagen con auto, o elige una relación de aspecto y un nivel de tamaño 1k o 2k. Cada edición tiene un precio único por imagen y no se aplica ningún filtro de contenido.
Elige un modo según tu punto de partida
| Lo que tienes | Modo |
|---|---|
| una descripción escrita | FLUX.2 Klein 4B Texto a imagen |
| de una a tres imágenes para modificar o combinar | FLUX.2 Klein 4B Edición de imagen |
Funciones y aspectos destacados
Hasta tres referencias
Combina dos retratos y un lugar, o cambia el estilo de una sola foto. El precio no cambia con el número de fuentes.
Ediciones que conservan a las personas
Pide un fondo, una luz o un clima nuevos y conserva los rostros, la ropa y la pose. Con una fuente funciona de forma limpia; con tres, los rostros pueden desviarse un poco.
Abierto y sin filtro
No se revisa ni se rechaza nada. En nuestras pruebas, las ediciones mantuvieron el original sin filtrar tal como era; solo el nivel Muy fuerte volvió suavizado.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Di qué debe cambiar y qué tiene que quedar igual, hasta 5.000 caracteres. Con varias fuentes, refiérete a ellas como imagen 1, imagen 2 e imagen 3. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | De una a tres imágenes de origen, de hasta 10 MB cada una, en el orden en que tu prompt las menciona. Obligatorio. mínimo 1 elementos · máximo 3 elementos |
aspect_ratio | No | Auto (predeterminado) conserva la forma de la primera fuente a alrededor de un megapíxel. O elige una de nueve relaciones de 21:9 a 9:21. |
resolution | No | 1k (predeterminado) o 2k, es decir, 2048 píxeles en el lado largo. Solo se aplica cuando eliges una relación de aspecto; con auto el tamaño es de alrededor de un megapíxel. |
seed | No | Un número de 0 a 2147483647. Reutilízalo para comparar ediciones mientras cambias un detalle del prompt. |
Precios
$0.013 / imagen
Se factura por imagen a un precio único, sin importar el número de imágenes de origen ni el nivel de tamaño. Las solicitudes fallidas no se cobran.
Casos de uso
Cambios de fondo y de ambiente
Lleva a una pareja de una calle soleada a una noche lluviosa de neón en una sola pasada.
Llevar personas a un lugar
Coloca dos retratos en la foto de un lugar para storyboards, portadas y hojas de personajes.
Cambios de estilo rápidos
Cambia la luz, la estación o la paleta mientras la composición se queda en su sitio.
Guía de prompts y consejos prácticos
Protege primero, cambia después
Abre con lo que debe seguir igual y luego describe solo el cambio. Las instrucciones cortas y concretas funcionan mejor.
Dale un papel a cada fuente
Con varias imágenes, indica qué aporta cada una: esta persona, aquella persona, este lugar.
Revisa los detalles
Con dos o tres fuentes, mira las manos, el cabello y los accesorios; puede aparecer un objeto pequeño de más. Ejecuta otra seed si algo no cuadra.
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-4b/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.
