Pular para o conteúdo principal
A edição de imagens na Venice é síncrona. Envie sua imagem de origem para /image/edit ou /image/multi-edit e o resultado editado volta na mesma resposta como um arquivo PNG. Para recortes, /image/background-remove retorna um PNG transparente.
Os endpoints de edição de imagem são experimentais e o comportamento específico de cada modelo pode mudar com o tempo.

Endpoints

Quando usar cada endpoint

  • Use /image/edit quando tiver uma imagem de origem e quiser alterar, remover ou reestilizar parte dela com um prompt.
  • Use /image/multi-edit quando precisar de controle extra a partir de máscaras, overlays ou camadas de referência.
  • Use /image/background-remove quando só quiser um sujeito de primeiro plano limpo, com transparência.
Para inpainting, use /image/edit ou /image/multi-edit. O antigo parâmetro inpaint em /image/generate está obsoleto.

Passo 1: Edite uma única imagem

A edição de imagem única é o fluxo de inpainting mais simples. Envie uma imagem mais um prompt curto, como “remova a placa”, “mude o céu para nascer do sol” ou “substitua o fundo por um cenário de estúdio”. Requisição:
Resposta (200): O corpo da resposta são dados binários crus image/png. Salve-os diretamente em um arquivo.

Passo 2: Use multi-edit para máscaras ou inpainting em camadas

/image/multi-edit aceita até três imagens. A primeira imagem é a imagem base. As demais são tratadas como camadas de edição ou máscaras, o que dá mais controle do que edição apenas por prompt. Essa é a melhor escolha quando você quer:
  • mirar uma região específica com uma máscara
  • combinar uma composição existente com um overlay
  • restringir a edição mais do que um prompt de imagem única permite
Requisição JSON:
Requisição multipart:
Como /image/edit, o corpo da resposta são dados crus image/png.
/image/multi-edit atualmente usa o campo modelId em vez de model no schema de requisição.

Dicas de inpainting

O inpainting baseado em prompt funciona melhor quando a instrução é curta e local:
  • remove the tree
  • change the sky to sunset
  • replace the logo with a blank sign
  • restore the torn corner of the photo
Para mudanças mais amplas de cena, descreva o que deve permanecer igual:
Se a edição continuar afetando a área errada, troque de /image/edit para /image/multi-edit e forneça uma máscara ou camada de overlay.

Passo 3: Remova o fundo

Use /image/background-remove quando quiser o sujeito de primeiro plano isolado sobre um fundo transparente. Esse endpoint retorna um PNG com transparência alfa. Usando uma URL de imagem:
Usando upload de arquivo local:
Use a remoção de fundo para:
  • fotos de produtos para e-commerce
  • fotos de perfil e retratos
  • assets que você planeja colocar sobre um novo fundo

Parâmetros da requisição

/image/edit

/image/multi-edit

/image/background-remove


Formatos de entrada suportados

Para endpoints de edição, as dimensões da imagem devem ser de no mínimo 65536 pixels e no máximo 33177600 pixels. Arquivos enviados devem ter menos de 25MB.

Modelos e preços

O modelo de edição padrão é qwen-edit, com preço de $0,04 por edição. Outros modelos com capacidade de edição podem ter preços e restrições diferentes. Veja:

Erros

Alguns modelos de edição têm políticas de conteúdo mais rigorosas do que modelos de geração de imagem. Por exemplo, qwen-edit bloqueia requisições envolvendo imagens sexuais explícitas, sexualização de menores ou violência do mundo real.

Workflows relacionados