/image/edit ou /image/multi-edit e o resultado editado volta na mesma resposta como um arquivo de imagem. Para recortes, /image/background-remove retorna um PNG transparente.
Endpoints
A Venice não tem um endpoint
/images/edits compatível com OpenAI, então chamadas do SDK da OpenAI como client.images.edit() retornam 404. Envie as edições para /image/edit.Quando usar cada endpoint
- Use
/image/editquando tiver uma imagem de origem e quiser alterar, remover ou reestilizar parte dela com um prompt. - Use
/image/multi-editquando precisar condicionar a edição a imagens de referência adicionais. - Use
/image/background-removequando 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:transparent_background é true. Defina output_format como jpeg, png ou webp para escolhê-lo explicitamente.
Os endpoints de edição não têm o parâmetro response_format, então não conseguem retornar a imagem como JSON em base64. Se você precisar de base64, codifique os bytes da resposta por conta própria.
Passo 2: Use multi-edit com imagens de referência
/image/multi-edit aceita múltiplas imagens, e o teto é específico de cada modelo. Leia model_spec.constraints.maxInputImages de GET /models?type=inpaint para obter o teto de um determinado modelo. Quando o campo está ausente, o teto é 3, ou 1 quando combineImages é false.
A primeira imagem é a imagem base. As demais são referências adicionais que condicionam a edição.
O endpoint público não tem canal de máscara. Imagens adicionais atuam como referências na imagem inteira, não como mapas de região. Não existe parâmetro
mask, e enviá-lo retorna um 400. Faça prompts precisos para restringir onde a edição se aplica.- combinar uma composição existente com uma imagem de referência adicional
- dar ao modelo exemplos do estilo, objeto ou textura a aplicar
- restringir a edição mais do que um prompt de imagem única permite
/image/edit, o corpo da resposta são dados crus de imagem, e o formato de saída segue as mesmas regras.
/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 treechange the sky to sunsetreplace the logo with a blank signrestore the torn corner of the photo
/image/edit para /image/multi-edit e forneça uma imagem de referência adicional mostrando o resultado desejado. Depois, descreva a alteração pretendida com precisão no prompt.
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:
- fotos de produtos para e-commerce
- fotos de perfil e retratos
- assets que você planeja colocar sobre um novo fundo
/image/generate, /image/edit e /image/multi-edit aceitam transparent_background: true em modelos suportados e retornam o canal alfa diretamente. Veja Imagens com fundo transparente para a comparação.
Parâmetros da requisição
/image/edit
/image/multi-edit
/image/background-remove
/image/background-remove usa um modelo interno fixo. Ele não aceita um campo model. Enviar um (por exemplo "model": "bria-bg-remover") retorna 400 porque model não é um campo reconhecido.Conteúdo adulto e safe mode
Tanto/image/edit quanto /image/multi-edit aceitam safe_mode (padrão: true). Quando habilitado, o conteúdo adulto na saída editada é embaçado, então envie safe_mode: false para receber a saída sem embaçamento:
safe_mode. Para edição sem censura, use qwen-edit-uncensored.
A diferença no nome de moderação entre endpoints confunde muita gente:
Passar
safe_mode para /images/generations retorna 400 com Unrecognized key(s) in object: 'safe_mode'.
Formatos de entrada suportados
Para endpoints de edição, as imagens devem ter no mínimo 256×256 pixels, e a contagem total de pixels não pode exceder 33.177.600 (resolução 8K). Arquivos enviados devem ter menos de
25MB.
Modelos e preços
O modelo de edição padrão éfirered-image-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. O aprimoramento de prompt adiciona **$0,04 por reescrita aplicada ao preço da edição.
Veja:
- Preços de imagens
- API de Models com
type=inpaint
Erros
Alguns modelos de edição têm políticas de conteúdo mais rigorosas do que modelos de geração de imagem. Requisições que violam a política do modelo selecionado são rejeitadas com
422.Workflows relacionados
- Use Geração de imagens quando estiver partindo de texto em vez de uma imagem existente.
- Use Aprimoramento de prompt para aprender como funciona a reescrita de edições com percepção visual.
- Use Modelos de imagem para comparar famílias de modelos de geração, edição e aprimoramento.
- Use a API de Edição de imagem, API de Multi-Edit e API de Remoção de fundo para detalhes completos do schema.