Introducción
FLUX 3 Klein Base Edición de imagen cambia o combina de una a tres imágenes de origen a partir de una instrucción escrita, con el FLUX 3 Image Klein Base de Black Forest Labs, el checkpoint de 5.6B sin destilar. Menciona las fuentes como image 1, image 2 e image 3, conserva la forma de la primera imagen con auto o elige una de quince, y elige 1k o 2k. Las ediciones tardaron unos 20 a 40 segundos en 1k en nuestras pruebas, y no se filtra nada.
Elige un modo según tu material de partida
| Lo que tienes | Modo |
|---|---|
| una descripción escrita | FLUX 3 Klein Base Texto a imagen |
| una a tres imágenes para cambiar o combinar | FLUX 3 Klein Base Edición de imagen |
Funciones y aspectos destacados
Prendas de una toma de producto
Da a la persona como image 1 y una prenda fotografiada en percha como image 2, y la edición viste a una con la otra. En nuestras pruebas, una mujer con parka de invierno salió con un vestido combinación de terciopelo borgoña en un vestidor de sauna, con su rostro y su pelo conservados.
La misma persona, un lugar nuevo
El rostro, la barba y la complexión se mantuvieron a través de un cambio completo de atuendo y de escenario: un excursionista con chaqueta roja en un bosque nevado se convirtió en el mismo hombre con una camisa de lino abierta en un banco de cedro. Las instrucciones cortas y concretas mantuvieron mejor los rostros.
Combina hasta tres imágenes
Dos fotos separadas de dos mujeres se convirtieron en una escena en un banco de sauna, con vestidos iguales y ambos rostros reconocibles. Con tres fuentes, di qué aporta cada una para que no se pierda ninguna.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Obligatorio, hasta 5.000 caracteres. Di qué debe quedar (rostro, pelo, complexión) y luego el cambio. mínimo 1 caracteres · máximo 5000 caracteres |
image_urls | Sí | Obligatorio, de una a tres enlaces públicos de imagen, de hasta 10 MB cada una. Un enlace que no abre o no es una imagen hace fallar la solicitud sin cargo. mínimo 1 elementos · máximo 3 elementos |
aspect_ratio | No | auto (predeterminado) conserva la forma de la primera fuente: un retrato de 880 x 1184 salió como 880 x 1184 en 1k y 1760 x 2368 en 2k. O elige una de quince formas de 3:1 a 1:3. |
resolution | No | 1k (predeterminado) o 2k, que también se aplica con auto. 2k cuesta unas cuatro veces más por la salida y el doble por cada fuente. |
output_format | No | JPEG (predeterminado), PNG o WebP. No cambia el precio. |
seed | No | Opcional, de 0 a 2147483647. Reutilízala para comparar cambios en la instrucción; las ediciones repetidas salieron parecidas, pero no siempre idénticas al píxel. |
Precios
Se factura por imagen: un cargo por el nivel de tamaño de salida más un cargo por cada imagen de origen, ambos más altos en 2k. La relación de aspecto y el formato de salida no cambian el precio.
| Especificación | Precio |
|---|---|
| $0.054 / imagen |
| $0.216 / imagen |
Casos de uso
Lookbooks y estilismo
Pon una prenda de una foto de producto sobre una modelo de otra foto, en un lugar y una luz nuevos, para lookbooks y tableros de inspiración.
Cambios de lugar y de vestuario
Mueve a una persona a un escenario y un atuendo nuevos en una sola pasada conservando quién es, para hojas de personaje y series.
Guía de prompts y consejos prácticos
Usa los números de imagen
Escribe image 1, image 2 e image 3 en el orden de subida y da a cada una un papel: la mujer de image 1, el vestido de image 2. La primera imagen también fija la forma cuando la relación de aspecto es auto.
Protege primero, cambia después
Empieza por lo que debe seguir igual, como rostro, pelo y complexión, y luego describe el cambio: prenda, lugar, pose y luz. El modelo puede dejar la ropa puesta, así que di exactamente qué debe llevar la persona.
Cuida el precio por fuente
Cada fuente suma al precio, y 2k duplica ese cargo. Usa una sola fuente cuando baste y haz borradores en 1k.
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-3-klein-base/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"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.
