Introducción
Envía una imagen de origen y describe el resultado. La intensidad decide cuánto se aleja la salida del original; si añades una máscara en blanco y negro, solo se vuelve a dibujar la zona blanca y el resto se queda como estaba. Puedes cargar hasta tres archivos LoRA entrenados para FLUX.1 [dev], el precio por imagen es fijo y nada se filtra.
| Campo | Valor |
|---|---|
| Entrada | Imagen |
| Salida | Imagen |
| Endpoints | Texto a imagen y edición de imagen (intensidad, máscara opcional de inpainting), ambos con soporte para LoRA |
| Modelo base | FLUX.1 [dev], el transformer de rectified flow de Black Forest Labs con 12 mil millones de parámetros |
| Entrada de LoRA | Hasta 3 entradas, cada una {path, scale}; path es una URL HTTPS directa a un archivo .safetensors |
| Fuerza del LoRA | De 0 a 4 por entrada (1 por defecto) |
| Guidance | De 0 a 20 (3.5 por defecto) |
| Tamaño de salida | Alrededor de un megapíxel: 1024 x 1024 en 1:1, 1344 x 768 en 16:9, 1536 x 640 en 21:9 |
| Relaciones de aspecto | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21 |
| Formatos de salida | JPEG (por defecto), PNG, WebP |
Funciones y aspectos destacados
Fotografías, no renders
Un LoRA Super Realism y un reservado de madrugada junto a una ventana con lluvia: dos hombres inclinados el uno hacia el otro bajo una lámpara colgante cálida. La piel, la tela y la luz de la ventana se ven como en una fotografía.
Un look de revista con una sola frase activadora
"MJ v6" y un LoRA de estilo Midjourney le dan a FLUX un acabado editorial satinado: un vestido de gala de satén rojo con la espalda descubierta en una escalera de mármol, iluminado de lado.
Cambia el medio por completo
Un LoRA de caricatura de extremidades alargadas en 1.2 convierte al mismo modelo en un ilustrador de pin-up: un paraguas rojo, una calle empedrada mojada y proporciones exageradas.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | Describe toda la imagen que quieres recibir. Con máscara, describe lo que debe aparecer en la zona blanca. mínimo 1 caracteres · máximo 5000 caracteres |
image_url | Sí | La imagen que quieres editar. El resultado conserva su forma a alrededor de 0,7 megapíxeles: en nuestras pruebas, un original de 1024 x 1536 volvió en 672 x 1008. |
mask_url | No | Opcional. Una imagen en blanco y negro del mismo tamaño que el original: las zonas blancas se redibujan según el prompt y las negras se conservan. |
strength | No | Cuánto se aleja del original, de 0 a 1 (por defecto 0,8). Con máscara, usa de 0,9 a 1 para que la zona blanca cambie de verdad. |
loras | No | Hasta tres entradas {path, scale} entrenadas para FLUX.1 [dev]; scale de 0 a 4, 1 es neutro. Usa un enlace directo público al archivo .safetensors. Valor predeterminado: |
guidance_scale | No | Qué tanto sigue el resultado al prompt, de 0 a 20 (por defecto 3,5). Los LoRA de realismo suelen verse más naturales un poco más abajo. |
steps | No | Pasos de eliminación de ruido, de 1 a 50 (por defecto 28). Más pasos tardan más en generarse. |
output_format | No | JPEG por defecto, PNG o WebP si los necesitas. No cambia el costo. |
seed | No | Mantiene los resultados comparables mientras ajustas la intensidad o la máscara; la misma semilla no garantiza una imagen idéntica. |
Precios
$0.018 / imagen
Se cobra por imagen a un precio fijo. La máscara, la intensidad, los pasos y los LoRA no tienen costo aparte.
Casos de uso
El LoRA que ya encontraste
Si el look que buscas está en Hugging Face o en un hub de la comunidad como LoRA de FLUX, aquí corre como una simple llamada a la API: pega el enlace del archivo, define el scale y escribe el prompt.
Imágenes de moda y editoriales
Los LoRA de realismo y de estilo revista te dan vestidos de gala con la espalda descubierta en escaleras de mármol y reservados de madrugada junto a ventanas con lluvia, con una luz y una piel creíbles.
Campañas estilizadas
Los LoRA de caricatura, pin-up e ilustración convierten una sola plantilla de prompt en una serie consistente en nueve relaciones de aspecto.
Imágenes sin censura
Los LoRA sin filtro se cargan sin revisión y el resultado no se filtra, para plataformas cuyos usuarios esperan esa libertad.
Guía de prompts y consejos prácticos
Busca la frase activadora del LoRA
La mayoría de los LoRA de FLUX indican una frase activadora en su ficha de modelo, como "Super Realism" o "MJ v6". Ponla al inicio del prompt y luego describe la imagen.
Ajusta el guidance con LoRA de realismo
El guidance por defecto es 3.5. Los LoRA de realismo suelen verse más naturales entre 2 y 3.5; los valores muy altos empujan hacia un look satinado y con exceso de nitidez.
Sube el scale en estilos fuertes
Algunos LoRA de estilo necesitan un scale mayor que 1 para imponerse. Nuestro ejemplo de caricatura corrió en 1.2; empieza en 1 y muévete en pasos de 0.2.
Comprueba que el archivo sea público
Usa un enlace directo que descargue el archivo .safetensors. Los repositorios restringidos responden con HTTP 401 y la solicitud falla antes de generar ninguna imagen.
Introducción
FLUX.1 Dev LoRA Edición de imagen cambia una imagen de origen en FLUX.1 [dev] de Black Forest Labs, guiada por tu prompt y hasta tres archivos LoRA propios. Sin máscara cambia el estilo de todo el encuadre, y una intensidad de 0 a 1 decide cuánto se aleja del original. Con una máscara en blanco y negro redibuja solo la zona blanca y conserva el resto. El resultado vuelve en JPEG, PNG o WebP a un precio fijo, y nada se filtra.
Elige el modo según tu material
| Lo que tienes | Modo |
|---|---|
| una imagen para cambiar, entera o en parte | FLUX.1 Dev LoRA Edición de imagen |
| solo una descripción escrita | FLUX.1 Dev LoRA Texto a imagen |
Funciones y puntos fuertes
Inpainting con máscara
Pinta de blanco la zona que quieres cambiar y de negro todo lo demás. En nuestras pruebas, una máscara sobre la parte superior del cuerpo de un retrato de estudio cambió solo esa zona, mientras que el rostro, el pelo y los pantalones se mantuvieron igual.
Una intensidad fácil de razonar
El valor por defecto 0,8 conserva la pose y la composición; 0,95 deja que el modelo redibuje casi todo, incluida la cara. Con máscara, de 0,9 a 1 asegura que la zona blanca cambie de verdad.
Sin censura y con pesos propios
El original, el prompt, los pesos y el resultado nunca se filtran. Con una intensidad de 0,95, un retrato de estudio se editó tal como pedía nuestra prueba más fuerte, con y sin un LoRA sin filtro.
Casos de uso
Cambiar una parte de una foto
Cambia un atuendo, un fondo o un objeto y deja intacto el resto de la imagen, para variantes de producto, pruebas de vestuario o retoque de retratos.
Cambiar el estilo con un LoRA de la comunidad
Pasa una foto por uno de los más de mil LoRA de FLUX para darle aspecto de película, brillo editorial o ilustración sin mover la composición.
Guía de prompts y consejos
Describe el resultado, no la instrucción
Escribe lo que debe contener la imagen final. Con una máscara, describe solo lo que debe ir en el área blanca, como «un top de terciopelo negro, luz de estudio suave».
Suaviza los bordes duros de la máscara
Un rectángulo duro deja una costura visible donde se junta con los píxeles conservados. Difumina el borde de la máscara o sigue el contorno del objeto que quieres reemplazar.
Empieza en 0,8 y muévete de 0,05 en 0,05
Si se nota demasiado el original, sube la intensidad; si la cara se desvía, bájala. Mantén fija la semilla al comparar para que solo cambie la intensidad.
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-dev-lora/edit",
"input": {
"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.
