/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.
Endpoints
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 de controle extra a partir de máscaras, overlays ou camadas de referência. - 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: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
/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 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 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:
- 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:
- 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. Por exemplo,
qwen-edit bloqueia requisições envolvendo imagens sexuais explícitas, sexualização de menores ou violência do mundo real.Workflows relacionados
- Use Geração de imagens quando estiver partindo de texto em vez de uma imagem existente.
- 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.