Black Forest Labs
FLUX.1 Fill Pro
flux-1-fill-pro
Modelo profesional de repintado local y extrapolación que sustituye, elimina o extiende áreas concretas de la imagen según una máscara binaria, manteniendo la coherencia de iluminación y perspectiva; requiere una máscara de entrada y está pensado para retoques precisos en lugar de la generación de imágenes completas
Probar flux-1-fill-pro
Entrada
Creaciones
Ver todas las creacionesSalida
imagePrecios
flux-1-fill-pro per image
| Precio unitario | $0.0715 |
|---|
Descripción general
flux-1-fill-pro es un modelo de reparación de imágenes orientado a la edición puntual: recibe una imagen original y una máscara en blanco y negro junto con un prompt de texto, y solo repinta la región blanca de la máscara mientras la región negra permanece intacta. Es adecuado para el retoque de imágenes de producto, la sustitución local de piezas en material de comercio electrónico, el ajuste de renders y la extensión del lienzo, entre otros escenarios que requieren modificaciones quirúrgicas sobre una composición existente. Los desarrolladores lo invocan a través de la interfaz unificada de HiAPI.ai, con facturación por imagen y sin necesidad de construir su propio flujo de edición de imágenes.
Aspectos clave
- Dirigido por máscara, repintado puntual——solo modifica la región blanca de la máscara; el resto de los píxeles permanece igual, ideal para modificaciones finas de sustitución, eliminación o adición de elementos.
- Una misma interfaz cubre reparación y expansión——realiza reparaciones locales sin alterar la estructura y, cuando se necesita, extiende el lienzo para ajustar el formato; ambas necesidades comparten el mismo conjunto de parámetros de entrada.
- Control de generación reproducible——controla la aleatoriedad y la fidelidad al prompt mediante seed, steps, guidance y prompt_upsampling, lo que facilita la generación por lotes y la verificación de regresiones.
Descripción de capacidades
Repintado local con máscara: al proporcionar la imagen original, una máscara en blanco y negro del mismo tamaño y un prompt, se puede sustituir o añadir contenido en la región especificada, conservando la región negra tal cual; es adecuado para la sustitución local de piezas y la corrección de defectos.
Extensión del lienzo y compleción de la composición: permite la extensión generativa de las áreas fuera de los límites de la imagen, útil para ajustar la relación de aspecto o completar el lienzo y adaptarse a los requisitos de tamaño de distintos canales de distribución.
Control de calidad parametrizado: los pasos de difusión (15–50) y la intensidad de guía (1.5–100) se ajustan según sea necesario; a más pasos, más fino el detalle pero mayor el tiempo de cómputo, y a mayor intensidad de guía, mayor la fidelidad al prompt.
Resultados reproducibles y selección de formato: fijar el seed permite reproducir resultados similares, lo que facilita las tareas por lotes y la comparación de efectos; la salida puede ser jpg o png, lista para el flujo posterior de material.
Interruptor de reescritura automática del prompt: prompt_upsampling está desactivado por defecto; al activarlo, el prompt se reescribe automáticamente para aportar creatividad. Si se necesita generar estrictamente según el texto original, debe permanecer desactivado.
Escenarios de aplicación
- Operaciones de comercio electrónico: sustitución local de piezas y corrección de defectos en imágenes de producto——con una máscara se delimita la pieza del producto o la mancha que se va a sustituir, se introduce una nueva descripción y se obtiene una imagen principal del producto lista para publicar, lo que reduce las nuevas sesiones de fotografía y la regeneración completa de la imagen.
- Equipos de diseño: ajuste local de renders y extensión del lienzo——se modifican regiones específicas de renders de arquitectura, interiores, etc., o se extiende el lienzo hacia fuera, generando imágenes adaptadas a distintos formatos y manteniendo la coherencia de iluminación y perspectiva.
- Tratamiento de material: eliminar elementos perturbadores y rellenar de forma natural——se marcan con una máscara los objetos no deseados en la imagen original, se describe el contenido de relleno mediante el prompt y se obtiene una imagen limpia para la maquetación y distribución posteriores.
Limitaciones y recomendaciones de selección
Antes de usarlo es imprescindible preparar una máscara en blanco y negro del mismo tamaño que la imagen original, lo que añade un paso de anotación o segmentación de regiones. Es un modelo de edición, no un modelo general de texto a imagen, por lo que no es adecuado para generar imágenes completas desde cero; el resultado depende de la calidad de la máscara y de la descripción del prompt, y los textos complejos y las estructuras finas pueden requerir varios ajustes. Las ediciones de gran área o de alta resolución aumentan notablemente el tiempo de cómputo y el coste de invocación; los escenarios sensibles al presupuesto o que requieran autoalojar los pesos deben evaluarse por separado.
Novedades
Ver el registro de cambios →- Nuevo modelo Nueva documentación de repintado local con máscara para flux-1-fill-pro
Preguntas frecuentes
Ver todas las preguntas →-
¿Qué es FLUX.1 Fill Pro?
FLUX.1 Fill Pro es un modelo de edición de imágenes orientado al inpainting con máscara: se sube la imagen original, una máscara en blanco y negro del mismo tamaño y un prompt, y solo se repinta la región blanca, mientras que la región negra permanece sin cambios.
-
¿Qué representan el negro y el blanco en la máscara?
La zona negra conserva la imagen original; la zona blanca se redibuja según el prompt; la máscara debe tener las mismas dimensiones que la imagen original.
-
¿Es necesario subir tanto la imagen como la máscara?
Sí. La interfaz pública actual requiere proporcionar tanto la imagen original como la máscara en blanco y negro; ambas son imprescindibles.
-
¿Qué se debe escribir en el prompt?
Describe únicamente el nuevo contenido que debe aparecer dentro del área blanca de la máscara e indica los elementos que deben conservarse; no repitas la descripción de la imagen fuera de la máscara.
Crear una tarea de generación
https://api.hiapi.ai/v1/tasks Encabezados
AuthorizationstringObligatorioClave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API
Content-TypestringOpcionalEl cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.
Idempotency-KeystringOpcionalClave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.
Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.
Cuerpo
modelstringObligatorioValor fijo actual: flux-1-fill-pro
routestringOpcionalValor fijo actual: default
inputobjectObligatorio
Objeto de parámetros de negocio para flux-1-fill-pro y la ruta default; consulta la tabla de parámetros a continuación.
maskstringObligatorioImagen de máscara en blanco y negro, utilizada para especificar la región a repintar: la zona negra permanece sin cambios y la zona blanca se repinta según el prompt. Admite formatos JPEG, PNG, GIF y WebP; las dimensiones deben coincidir con las de la imagen original.
seedintegerOpcionalSemilla aleatoria; al fijar este valor se pueden reproducir resultados similares. Si no se envía, se genera de forma aleatoria.
imagestringObligatorioImagen original que se va a editar; admite formatos JPEG, PNG, GIF y WebP y puede incluir una máscara alfa. Si se utiliza una máscara independiente, asegúrese de que sus dimensiones coincidan con las de la imagen original.
stepsintegerOpcionalPredeterminado: 50min 15max 50Número de pasos de difusión; rango de valores de 15 a 50, valor predeterminado 50. Cuanto mayor sea el valor, más finos serán los detalles y más tiempo tardará.
promptstringObligatoriominLength 1maxLength 4000Describe el contenido que se va a generar o reemplazar en la zona blanca de la máscara; máximo 4000 caracteres.
guidancenumberOpcionalPredeterminado: 60min 1.5max 100Intensidad de guía del prompt; rango de valores de 1.5 a 100, valor predeterminado 60. Cuanto mayor sea el valor, más se ajustará al prompt, pero puede reducir la naturalidad de la imagen.
output_formatstringOpcionalPredeterminado: "jpg"Formato de la imagen de salida; los valores son jpg o png, valor predeterminado jpg.
jpgpngprompt_upsamplingbooleanOpcionalPredeterminado: falseIndica si se reescribe automáticamente el prompt para aumentar la creatividad; valor predeterminado false. Debe desactivarse cuando se requiera generar estrictamente según el texto original.
callbackobjectOpcional
Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.
Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.
urlstringObligatorioObligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.
whenstringOpcionalPredeterminado: "final"Actualmente solo se admite final: notifica tanto en success como en fail.
finalstoragestringOpcionalPredeterminado: "temp"Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.
temppersistentEjemplos de solicitud
# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-1-fill-pro",
"input": {
"mask": "…",
"image": "…",
"steps": 50,
"prompt": "…",
"guidance": 60,
"output_format": "jpg",
"prompt_upsampling": false
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "flux-1-fill-pro",
input: {
"mask": "…",
"image": "…",
"steps": 50,
"prompt": "…",
"guidance": 60,
"output_format": "jpg",
"prompt_upsampling": false
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "flux-1-fill-pro",
"input": {
"mask": "…",
"image": "…",
"steps": 50,
"prompt": "…",
"guidance": 60,
"output_format": "jpg",
"prompt_upsampling": False
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtener el detalle de la tarea
https://api.hiapi.ai/v1/tasks/:id Campos de respuesta
taskIdstringObligatorioID de tarea, siempre con prefijo tk-hiapi-.
modelstringObligatorioNombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.
routestringOpcionalSolo aparece si se usó el parámetro route explícito; repite el valor enviado.
statusstringObligatorioEstado de la tarea.
queued En cola, sin iniciar.
handling Procesando.
archiving Proceso terminado, preparando artefactos.
success Terminal: completado, artefactos disponibles (se devuelve output).
fail Terminal: error (se devuelve error).
Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.
creatednumberObligatorioHora de creación de la tarea (segundos Unix).
completednumberObligatorioSegundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.
outputarrayOpcional
Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).
Array [ object ]
Elementos del array
urlstringObligatorioURL del artefacto, descargable directamente.
typestringObligatorioValores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.
expireAtnumberObligatorioSegundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.
errorobjectOpcional
Solo con status == fail.
codestringObligatorioCódigo de error de negocio.
messagestringObligatorioDescripción del error.
Ejemplos de respuesta
Éxito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En proceso (no terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Fallido
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Artículos
Ver todos los artículos →-
Tutorial
Cómo llamar a hailuo-2.3/text-to-video mediante la API de HiAPI: curl, Python y ejemplos de solicitud ejecutables
-
Tutorial
Cómo llamar a kling-4.0/image-to-video en HiAPI: curl, Python y sondeo
-
Comparativa
Recraft v4.1 Flash comparativa horizontal de texto a imagen: guía de selección y migración para desarrolladores
Con un coste de $0.01 por imagen y capacidad pura de texto a imagen, evalúa si encaja en tu pipeline de generación de imágenes
-
Comparativa
hailuo-2.3-fast/image-to-video comparativa horizontal: cómo elegir un modelo de imagen a video y puntos clave para migrar
-
Tutorial
Cómo llamar a hailuo-2.3-fast/image-to-video a través de la API de HiAPI: práctica con curl y Python
La primera solicitud ejecutable del nivel rápido y de bajo coste de imagen a vídeo: del ID del modelo a la descarga del MP4
-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video en HiAPI: curl + Python
Realiza una solicitud de imagen a video funcional en HiAPI: desde la carga del primer fotograma hasta el sondeo asíncrono y la descarga final
-
Tutorial
Cómo usar kling-4.0/text-to-video a través de la API de HiAPI: curl, Python y un ejemplo de solicitud ejecutable
Guía práctica para desarrolladores: prompts cinematográficos, audio sincronizado, sondeo asíncrono y descarga de resultados
-
Tutorial
Uso de Kandinsky 6.0 Pro texto a video en HiAPI: tutorial con curl y Python
Demostración práctica centrada en la solicitud: construir la llamada de prompt a clip de video, enviar la solicitud, sondear el estado de finalización y descargar el resultado
Modelos relacionados
Ver todos los modelos →Mismo tipo
-
GPT Image 2.5 OpenAI $0.017 /imagen -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /imagen -
FLUX 3 Image Black Forest Labs $0.041 /imagen -
Nano Banana Google $0.021 /imagen -
GPT Image 2 OpenAI $0.007 /imagen -
Krea 3 Krea $0.036 /imagen -
Nano Banana 2 Google $0.036 /imagen -
Krea 2 Medium Turbo Krea $0.021 /imagen -
Grok Imagine Quality xAI $0.070 /imagen -
Recraft V4.1 Recraft $0.010 /imagen -
FLUX.1 Schnell Black Forest Labs $0.005 /imagen -
FLUX.1 Kontext Max Black Forest Labs $0.071 /imagen
Mismo proveedor
-
FLUX.1 Kontext Max Black Forest Labs $0.071 /imagen -
FLUX.2 Klein 4B Black Forest Labs $0.0004 /imagen -
FLUX 3 Video Black Forest Labs $0.090 /segundo -
FLUX.2 Black Forest Labs $0.035 /imagen -
FLUX.1 Schnell Black Forest Labs $0.005 /imagen -
FLUX 1.1 Pro Black Forest Labs $0.050 /imagen -
FLUX.2 Klein 9B Black Forest Labs $0.0086 /imagen -
FLUX 3 Image Black Forest Labs $0.041 /imagen -
FLUX 3 Max Black Forest Labs $0.061 /segundo

![FLUX.1 Fill [pro] 概念 art del mundo: extensión de la cresta montañosa en la distancia](https://static.hiapi.ai/_i/v1/FFXyuyR-n_cY3KSvjHMQfw/7SbeuZdKdHydTU940SQckw.webp)









