/image/edit o /image/multi-edit y el resultado editado vuelve en la misma respuesta como archivo PNG. 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:image/png. Guárdalos directamente en un archivo.
Paso 2: usa multi-edit para máscaras o inpainting en capas
/image/multi-edit acepta hasta tres imágenes. La primera imagen es la imagen base. Las imágenes restantes se tratan como capas de edición o máscaras, lo que te da más control que la edición solo con prompt.
Es la mejor elección cuando quieres:
- 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 image/png en bruto.
/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
Parámetros de la solicitud
/image/edit
/image/multi-edit
/image/background-remove
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 esqwen-edit, con precio de $0.04 por edición. Otros modelos con capacidad de edición pueden tener precios y restricciones diferentes.
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. Por ejemplo,
qwen-edit bloquea solicitudes que impliquen imágenes sexuales explícitas, menores sexualizados o violencia del mundo real.Flujos relacionados
- Usa Generación de imágenes cuando partes de texto en lugar de una imagen existente.
- 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.