/image/edit o /image/multi-edit y el resultado editado vuelve en la misma respuesta como archivo de imagen. Para recortes, /image/background-remove devuelve un PNG transparente.
Endpoints
Cuándo usar cada endpoint
- Usa
/image/editcuando tienes una imagen fuente y quieres cambiar, eliminar o restilizar parte de ella con un prompt. - Usa
/image/multi-editcuando necesitas más control mediante máscaras, overlays o capas de referencia. - Usa
/image/background-removecuando solo quieres un sujeto en primer plano limpio con transparencia.
Para inpainting, usa
/image/edit o /image/multi-edit. El antiguo parámetro inpaint en /image/generate está deprecado.Paso 1: edita una sola imagen
La edición de imagen única es el flujo más simple de inpainting. Envía una imagen más un prompt corto como “remove the sign”, “change the sky to sunrise” o “replace the background with a studio backdrop”. Solicitud:transparent_background es true. Establece output_format en jpeg, png o webp para elegirlo explícitamente.
Paso 2: usa multi-edit para máscaras o inpainting en capas
/image/multi-edit acepta múltiples imágenes, y el tope es específico de cada modelo. Lee model_spec.constraints.maxInputImages en GET /models?type=inpaint para conocer el tope de un modelo concreto. Cuando el campo no está presente, el tope es 3, o 1 cuando combineImages es false.
La primera imagen es la imagen base. Las imágenes restantes son referencias adicionales que condicionan la edición.
El endpoint público no tiene canal de máscara. Las imágenes adicionales actúan como referencias sobre toda la imagen, no como mapas de regiones: no existe el parámetro
mask, y enviarlo devuelve un 400. Redacta el prompt con precisión para acotar dónde se aplica la edición.- apuntar a una región específica con una máscara
- combinar una composición existente con un overlay
- restringir la edición más estrechamente de lo que puede hacer un prompt en una sola imagen
/image/edit, el cuerpo de la respuesta es datos de imagen en bruto, y el formato de salida sigue las mismas reglas.
/image/multi-edit usa actualmente el campo modelId en lugar de model en el esquema de la solicitud.Consejos para inpainting
El inpainting basado en prompt funciona mejor cuando la instrucción es corta y local:remove the treechange the sky to sunsetreplace the logo with a blank signrestore the torn corner of the photo
/image/edit a /image/multi-edit y proporciona una máscara o capa de overlay.
Paso 3: elimina el fondo
Usa/image/background-remove cuando quieras el sujeto en primer plano aislado sobre un fondo transparente. Este endpoint devuelve un PNG con transparencia alfa.
Usando una URL de imagen:
- fotos de producto de ecommerce
- fotos de perfil y retratos
- activos que planeas colocar sobre un nuevo fondo
/image/generate, /image/edit y /image/multi-edit aceptan transparent_background: true en los modelos compatibles y devuelven el canal alfa directamente. Consulta Imágenes con fondo transparente para ver la comparación.
Parámetros de la solicitud
/image/edit
/image/multi-edit
/image/background-remove
/image/background-remove usa un modelo interno fijo. No acepta un campo model. Enviar uno (por ejemplo "model": "bria-bg-remover") devuelve 400 porque model no es un campo reconocido.Contenido adulto y modo seguro
Tanto/image/edit como /image/multi-edit aceptan safe_mode (predeterminado: true). Cuando está habilitado, el contenido adulto en la salida editada se difumina, así que envía safe_mode: false para recibir la salida sin difuminar:
safe_mode. Para edición sin censura, usa qwen-edit-uncensored.
La diferencia en el nombre de moderación entre endpoints suele confundir:
Pasar
safe_mode a /images/generations devuelve 400 con Unrecognized key(s) in object: 'safe_mode'.
Formatos de entrada admitidos
Para los endpoints de edición, las dimensiones de la imagen deben ser de al menos
65536 píxeles y no más de 33177600 píxeles. Los archivos subidos deben ser de menos de 25MB.
Modelos y precios
El modelo de edición predeterminado esfirered-image-edit, con precio de 0.04 por reescritura aplicada al precio de la edición.
Consulta:
- Precios de imagen
- API de Models con
type=inpaint
Errores
Algunos modelos de edición tienen políticas de contenido más estrictas que los modelos de generación de imagen. Las solicitudes que infringen la política del modelo seleccionado se rechazan con
422.Flujos relacionados
- Usa Generación de imágenes cuando partes de texto en lugar de una imagen existente.
- Usa Mejora de prompts para aprender cómo funciona la reescritura de ediciones con conciencia visual.
- Usa Modelos de imagen para comparar familias de modelos de generación, edición y mejora.
- Usa la API de edición de imagen, la API multi-edit y la API de eliminación de fondo para detalles completos del schema.