Saltar para o conteúdo principal

1. Obter a API Key

Abra a lista de aplicações do Ace Data Cloud, entre em uma aplicação disponível e copie a API Key. Obter a API Key do Ace Data Cloud

2. Editar usando URL da imagem

Imagem original: Imagem original para edição do GPT Image 2
Resposta bem-sucedida:
Este é o resultado da edição efetivamente concluída por meio do Ace Data Cloud em 8 de setembro de 2026: a caneca ficou laranja, o fundo ficou azul-marinho escuro, e a composição original e o tamanho de 1024×1536 foram mantidos: Resultado da edição da caneca laranja do GPT Image 2

3. Carregar imagem local

Use multipart/form-data:
É possível enviar image repetidamente, e a série GPT Image oferece suporte a no máximo 16 imagens de referência. O image em solicitações JSON pode ser uma única URL ou uma matriz de URLs; arquivos locais são enviados usando multipart.

Modelos e formas de cobrança

O preço exibido na página para o canal de API oficial é uma estimativa antes da solicitação; o valor final deve ser baseado no uso real de Tokens na resposta e nos registros de uso.

4. Usar máscara para edição local

A interface oficial Images Edit usa mask para especificar as áreas permitidas para modificação. Os modelos :official do Ace Data Cloud seguem o mesmo contrato multipart:
  • mask deve ser um PNG com canal Alpha e ter tamanho máximo de 4 MB;
  • O tamanho da máscara deve ser exatamente igual ao da primeira image;
  • Pixels transparentes com Alpha igual a 0 indicam que a edição é permitida, enquanto pixels não transparentes indicam que devem ser preservados;
  • Imagens RGB que são apenas em preto e branco, mas não têm canal de transparência, não podem ser usadas como máscaras válidas;
  • O prompt deve descrever a imagem completa esperada, ao mesmo tempo em que deixa claras as modificações locais e o conteúdo que precisa permanecer inalterado.
A seguir, gere primeiro uma máscara a partir da imagem original. O exemplo define o retângulo central como transparente, permitindo que o modelo modifique somente essa área:
Depois, envie a imagem original e a máscara juntas:
Também é possível continuar usando a forma de chamada images.edit do SDK Python oficial da OpenAI; basta apontar base_url para o Ace Data Cloud:
Ao usar mask, a imagem original e a máscara devem ser enviadas no mesmo pedido multipart separadamente por meio de image=@input.png e mask=@mask.png. Não misture uma imagem original por URL com um arquivo de máscara local; solicitações de edição somente por URL não oferecem suporte à adição de um arquivo mask local. A máscara restringirá a área de edição, mas o modelo de geração ainda poderá fazer uma mesclagem natural nas bordas; quando forem necessários limites rigorosos, use bordas Alpha nítidas e repita no prompt quais conteúdos devem permanecer inalterados. As formas de chamada acima são consistentes com os exemplos de máscara da OpenAI Image Edit API e do Cookbook oficial do GPT Image.

5. Parâmetros comuns

As regras de tamanho são consistentes com a interface de geração: a largura e a altura devem ser múltiplos de 16, o lado maior não pode exceder 3840, o total de pixels deve ser de 655.360–8.294.400, e a proporção de aspecto não pode exceder 3:1. Ao omitir size ou usar auto, o modelo escolherá o formato com base no prompt e na primeira imagem de referência. gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst e gpt-image-2:reverse são cobrados pelo número de imagens bem-sucedidas; gpt-image-2:official, gpt-image-2.5-flare:official e gpt-image-2.5-sunburst:official são cobrados com base nos Tokens reais de entrada de texto, entrada de imagem de referência e saída de imagem, prevalecendo os registros de uso.

6. Callback assíncrono e solução de problemas

Tarefas longas podem adicionar o seguinte à solicitação:
A resposta assíncrona 200 é {"task_id": "..."}; após a conclusão, o resultado final é enviado por callback. Solicitações síncronas retornam created e data. As respostas de erro incluirão trace_id. Ao relatar problemas, forneça esse ID; não forneça a API Key. Os campos completos e as enumerações em tempo real devem seguir a página OpenAI Images Edits API. Para geração de imagens a partir de texto puro, consulte Geração de imagens GPT Image 2 / 2.5.