Skip to Content
ModelosGPT ImageEditar e combinar imagens

Editar e combinar imagens

Enviar uma ou mais imagens e alterá-las ou mesclá-las com um prompt.

Não vai escrever código? Consulte Gerar imagens nas suas próprias ferramentas.

POST/v1/images/editsParâmetros comuns

Antes de começar

Você precisa deDetalhes
Chave de APICrie uma no console da OfoxAI  e substitua YOUR_OFOX_API_KEY no código
AmbienteO cURL precisa do jq para decodificar a imagem; o Python precisa de pip install openai; Node.js 18 ou superior, sem dependências
ImagensColoque um input.png no diretório atual; para combinar imagens, adicione também um input2.png. PNG ou JPEG, ≤ 15 MB cada
TimeoutDefina o timeout do cliente em 600 segundos. Alta qualidade, tamanhos grandes ou edição podem levar vários minutos
Valores usados no código
URL da APIhttps://api.ofox.io/v1
ID do modeloopenai/gpt-image-2.5-sunburstOs exemplos usam flare; para edição, recomenda-se sunburst
Chave de APISubstitua YOUR_OFOX_API_KEY no código pela sua chave
Dependências Pythonpip install openai

Editar uma imagem

Todos os exemplos abaixo foram executados sem alterações. O resultado é salvo como output.png no diretório atual.

Terminal
curl -s https://api.ofox.io/v1/images/edits \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -F "model=openai/gpt-image-2.5-flare" \ -F "image=@input.png" \ -F "prompt=Replace the background with a wooden table, keep the subject unchanged" \ -F "quality=low" \ -o response.json jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

Se você omitir size, o modelo escolhe o tamanho de saída, que pode ser diferente do original. Para manter o tamanho original, informe-o explicitamente, por exemplo size=1024x1024.

Como escrever o prompt

Deixe duas coisas claras: o que mudar e o que manter.

Caso de usoExemplo de prompt
Editar uma imagemSubstitua o fundo por um tampo de mesa de madeira e mantenha o objeto principal inalterado
Combinar imagensColoque o objeto principal da primeira imagem sobre o fundo da segunda imagem

Com várias imagens, refira-se a elas na ordem de envio como “a primeira imagem” e “a segunda imagem”. Para alterar apenas uma pequena parte da imagem, o Inpainting é mais confiável.

Combinar várias imagens

Envie várias imagens de referência de uma só vez. A ordem de envio determina a que se referem “a primeira imagem” e “a segunda imagem” no seu prompt. Coloque input.png e input2.png no diretório atual.

Terminal
# Up to 16 images per request, ≤ 15 MB each curl -s https://api.ofox.io/v1/images/edits \ -H "Authorization: Bearer YOUR_OFOX_API_KEY" \ -F "model=openai/gpt-image-2.5-flare" \ -F "image[]=@input.png" \ -F "image[]=@input2.png" \ -F "prompt=Place the subject of the first image onto the background of the second" \ -F "quality=low" \ -o response.json jq -r '.data[0].b64_json' response.json | base64 --decode > output.png

Provedores

Não é necessário fixar um provedor. Para os três modelos, tanto o Azure quanto a OpenAI atendem o endpoint de edição, e o gateway roteia as requisições automaticamente.

Se houver requisitos de moderação de conteúdo, você pode selecionar um provedor, mas o endpoint de edição aceita apenas o cabeçalho X-OfoxAI-Provider-Type; extra_body no formulário é ignorado. Com um provedor selecionado, as requisições não terão fallback para outro provedor caso ele esteja indisponível. Consulte Selecionar um provedor.

Valores dos parâmetros

Parâmetros específicos do endpoint de edição. model, n, output_format e os demais funcionam como em texto para imagem — consulte Texto para imagem · Valores dos parâmetros.

Obrigatórios
imageobrigatóriofileform

A imagem a ser editada. Para várias imagens, repita o campo como image[]; com o SDK Python, passe uma lista.

▸ Detalhes

As imagens de referência também são cobradas como tokens: uma imagem de referência de 1024×1024 resultou em 1.024 tokens de entrada na medição, por isso a edição custa mais que texto para imagem no mesmo tamanho.

▶Avançados · 1X-OfoxAI-Provider-TypeExpand
X-OfoxAI-Provider-Typestringheader· valoresazure_foundryopenai

Normalmente não é necessário — o gateway roteia automaticamente. Use-o apenas para fixar um provedor específico.

Limites de upload

ItemLimite
Cada imagem de referência≤ 15 MB
Requisição inteira≤ 50 MB
Quantidade de imagensSem limite no gateway; mantenha em 16 ou menos
FormatoPNG, JPEG

O modelo redimensiona as imagens de referência para cerca de 1024 px. Arquivos acima de 5 MB apenas tornam o upload mais lento; não melhoram o resultado.

Erros comuns

ErroCausaSolução
Invalid image file or modeA imagem enviada não é um PNG ou JPEG padrãoExporte novamente como PNG ou JPEG
Invalid file 'image[0]': unsupported mimetypeO arquivo enviado não é uma imagemEnvie uma imagem PNG, JPEG ou WebP
does not support the 'input_fidelity' parameterinput_fidelity foi enviadoRemova-o; esta família sempre processa imagens de referência em alta fidelidade
moderation_blockedO prompt ou a imagem de referência foi bloqueado pelo sistema de segurança do provedor upstreamAltere o prompt ou a imagem de referência e tente novamente
provider_type_unavailableO provedor fixado manualmente não atende este modeloRemova o cabeçalho X-OfoxAI-Provider-Type
Invalid sizeO tamanho informado viola uma das quatro regrasConsulte Tamanho
404 model_not_foundID do modelo com erro de digitação ou de maiúsculas/minúsculasCopie o ID do modelo desta página

Para outros erros, consulte a tabela completa de erros.

Documentação oficial

A documentação da OpenAI descreve o comportamento ao chamar a OpenAI diretamente. Ao chamar pela OfoxAI, os resultados medidos nestas páginas prevalecem. Por exemplo, não é necessário fixar um provedor para edição.

Last updated on