Referência da API
Guias de Integração
Preços e Faturamento
OpenAI
Edição de Imagens com GPT-Image-1
Use POST /v1/images/edits com gpt-image-1 na CometAPI para editar imagens via máscaras, prompts e opções de tamanho, alinhado ao comportamento de edição de imagens da OpenAI.
POST
/
v1
/
images
/
edits
Edit images
curl --request POST \
--url https://api.cometapi.com/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=Add a small red ribbon to the paper boat.' \
--form image='@example-file' \
--form mask='@example-file'{
"created": 1773381100,
"usage": {
"input_tokens": 226,
"input_tokens_details": {
"image_tokens": 194,
"text_tokens": 32
},
"output_tokens": 4160,
"total_tokens": 4386
},
"data": [
{
"b64_json": "<base64-image-data>"
}
]
}Use esta rota para editar imagens existentes com uploads multipart compatíveis com OpenAI na CometAPI.
Use esta rota quando
- Você já tem uma imagem de origem e quer uma edição guiada por prompt
- Você pode precisar de uma máscara para alterações direcionadas
- Você consegue lidar com upload de arquivo multipart em vez de uma solicitação JSON simples
Primeiro caminho de validação
- Comece com um arquivo PNG ou JPG
- Ignore a máscara até que o fluxo básico de edição funcione
- Use uma instrução curta pedindo uma única alteração visível
- Espere uma latência maior do que na geração simples de imagens
Comportamento do modelo
gpt-image-1,gpt-image-1-miniegpt-image-1.5são melhor tratados como rotas de edição com foco em base64dall-e-3pode retornar saída em URL quando o caminho do provedor oferecer suporteqwen-image-editsegue o comportamento de edição específico do provedor por trás da mesma rota da CometAPI
A validação em ambiente real em 2026-03-13 confirmou que uma solicitação
gpt-image-1 baseada em PNG foi bem-sucedida quando recebeu um timeout maior. A resposta retornou usage.input_tokens, usage.output_tokens, usage.total_tokens e um payload data[0].b64_json.Autorizações
Bearer token authentication. Use your CometAPI key.
Corpo
multipart/form-data
Source image file. Start with one PNG or JPG input for the simplest flow.
Edit instruction describing the change you want.
Exemplo:
"Add a small red ribbon to the paper boat."
The image editing model to use. Choose a current model from the Models page.
Optional PNG mask. Transparent areas indicate regions that should be edited.
Number of edited images to return.
Quality setting for models that support it.
Opções disponíveis:
high, medium, low Requested output format when supported by the selected model.
Opções disponíveis:
url, b64_json Requested output size when supported by the selected model.
⌘I
Edit images
curl --request POST \
--url https://api.cometapi.com/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=Add a small red ribbon to the paper boat.' \
--form image='@example-file' \
--form mask='@example-file'{
"created": 1773381100,
"usage": {
"input_tokens": 226,
"input_tokens_details": {
"image_tokens": 194,
"text_tokens": 32
},
"output_tokens": 4160,
"total_tokens": 4386
},
"data": [
{
"b64_json": "<base64-image-data>"
}
]
}