Skip to main content
La edición de imágenes en Venice es síncrona. Envía tu imagen fuente a /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.
Los endpoints de edición de imagen son experimentales y el comportamiento específico del modelo puede cambiar con el tiempo.

Endpoints

Cuándo usar cada endpoint

  • Usa /image/edit cuando tienes una imagen fuente y quieres cambiar, eliminar o restilizar parte de ella con un prompt.
  • Usa /image/multi-edit cuando necesitas más control mediante máscaras, overlays o capas de referencia.
  • Usa /image/background-remove cuando 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:
Respuesta (200): El cuerpo de la respuesta es datos binarios en bruto 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
Solicitud JSON:
Solicitud multipart:
Al igual que /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 tree
  • change the sky to sunset
  • replace the logo with a blank sign
  • restore the torn corner of the photo
Para cambios de escena más amplios, describe lo que debe permanecer igual:
Si la edición sigue afectando al área equivocada, cambia de /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:
Usando subida de archivo local:
Usa la eliminación de fondo para:
  • 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 es qwen-edit, con precio de $0.04 por edición. Otros modelos con capacidad de edición pueden tener precios y restricciones diferentes. Consulta:

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