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.
Antes de começar
https://api.ofox.io/v1openai/gpt-image-2.5-sunburstOs exemplos usam flare; para edição, recomenda-se sunburstpip install openaiEditar uma imagem
Todos os exemplos abaixo foram executados sem alterações. O resultado é salvo como output.png no diretório atual.
cURL
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.pngSe 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.
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.
cURL
# 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.pngProvedores
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.
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
Normalmente não é necessário — o gateway roteia automaticamente. Use-o apenas para fixar um provedor específico.
Limites de upload
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
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.