Skip to main content
POST
Use esta rota para editar imagens existentes com uploads multipart compatíveis com OpenAI no CometAPI.

​
Use esta rota quando

  • Você já tem uma imagem de origem e quer uma edição orientada por prompt
  • Talvez precise de uma máscara para alterações direcionadas
  • Você consegue lidar com upload de arquivo multipart em vez de uma solicitação JSON simples

​
Primeira solicitação segura

  • Comece com um arquivo PNG ou JPG
  • Ignore a máscara até que o fluxo básico de edição funcione
  • Use model: "gpt-image-2" para solicitações de edição de imagem GPT nesta rota
  • Use uma instrução curta que peça uma única alteração visível
  • Leia o resultado editado em data[0].b64_json
  • Defina output_format: "jpeg" quando quiser uma carga útil JPEG
  • Espere uma latência maior do que na geração simples de imagem

​
Comportamento do modelo

  • Os modelos de edição de imagem GPT nesta rota retornam dados de imagem base64 inline
  • output_format controla o tipo de imagem codificada dentro de b64_json
  • response_format só importa quando um modelo oferece suporte à saída por URL
  • qwen-image-edit segue o comportamento de edição específico do provedor por trás da mesma rota do CometAPI

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

multipart/form-data
​
image
file
obrigatório

Source image file. Start with one PNG or JPG input for the simplest flow.

​
prompt
string
obrigatório

Edit instruction describing the change you want.

Exemplo:

"Add a small red ribbon to the paper boat."

​
model
string
padrão:gpt-image-2

The image editing model to use. Choose a supported model from the Models page.

​
mask
file

Optional PNG mask. Transparent areas mark the regions to edit. The mask dimensions must match the source image exactly.

​
n
string
padrão:1

Number of edited images to return.

​
quality
enum<string>

Quality setting for models that support it.

Opções disponíveis:
high,
medium,
low
​
response_format
enum<string>

Requested response container when supported by the selected model. GPT image edit models return data[].b64_json; use output_format to choose the encoded image type.

Opções disponíveis:
url,
b64_json
​
output_format
string

Encoded image type for GPT image edit results returned in data[].b64_json. For example, use jpeg for a JPEG payload.

Exemplo:

"jpeg"

​
size
string

Requested output size when supported by the selected model.

Resposta

200 - application/json

Edited image result.

​
created
integer
obrigatório
​
usage
object
obrigatório
​
data
object[]
obrigatório
​
background
string

Background mode returned by models that expose it.

​
output_format
string

Encoded image type returned by GPT image models.

​
quality
string

Quality level returned by models that expose it.

​
size
string

Output size returned by models that expose it.