Criar edição de imagem

curl https://api.cometapi.com/v1/images/edits \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F image=@cat.jpg \ -F prompt="Add a small red bow tie on the cat" \ -F model=gpt-image-2 \ -F quality=low

{ "created": 1781075000, "background": "opaque", "output_format": "png", "quality": "low", "size": "1024x1024", "usage": { "input_tokens": 784, "input_tokens_details": { "image_tokens": 768, "text_tokens": 16 }, "output_tokens": 196, "output_tokens_details": { "image_tokens": 196, "text_tokens": 0 }, "total_tokens": 980 }, "data": [ { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." } ] }

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.

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

Show child attributes

data

object[]

obrigatório

Show child attributes

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.

curl https://api.cometapi.com/v1/images/edits \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F image=@cat.jpg \ -F prompt="Add a small red bow tie on the cat" \ -F model=gpt-image-2 \ -F quality=low

Moderação de conteúdo

Chaves de API

Use esta rota quando

Primeira solicitação segura

Comportamento do modelo

Autorizações

Corpo

Resposta

​Use esta rota quando

​Primeira solicitação segura

​Comportamento do modelo

Autorizações

Corpo

Resposta

Use esta rota quando

Primeira solicitação segura

Comportamento do modelo