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 de imagen. 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.
Establece enhance_prompt: true en cualquiera de los endpoints de edición para que un mejorador con conciencia visual analice la imagen o imágenes de entrada y reescriba tu instrucción antes de editar. Consulta Mejora de prompts para conocer el comportamiento, los precios y los detalles de las cabeceras de respuesta.

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 de imagen en bruto. Guárdalos directamente en un archivo. El formato es PNG para ediciones 1K y JPEG para ediciones 2K y 4K, o PNG en cualquier resolución cuando 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.
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 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 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
Si de todos modos vas a generar o editar la imagen, puedes ahorrarte esta segunda llamada: /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:
La salida para adultos (NSFW) sin difuminar está disponible para todos los usuarios de la API. No necesitas una suscripción Pro, y la configuración del filtro de contenido maduro en la app de Venice no afecta a las solicitudes de imágenes realizadas a través de la API. Las políticas de contenido varían según el modelo de edición y se aplican independientemente de 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 es firered-image-edit, con precio de 0.04poredicioˊn∗∗.Otrosmodelosconcapacidaddeedicioˊnpuedentenerpreciosyrestriccionesdiferentes.Lamejoradepromptsan~ade∗∗0.04 por edición**. Otros modelos con capacidad de edición pueden tener precios y restricciones diferentes. La mejora de prompts añade **0.04 por reescritura aplicada al precio de la edición. Consulta:

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