Riferimento API
Guide all'integrazione
Prezzi e fatturazione
OpenAI
Modifica delle immagini con GPT-Image-1
Usa POST /v1/images/edits con gpt-image-1 in CometAPI per modificare immagini tramite mask, prompt e opzioni di dimensione, in linea con il comportamento di modifica immagini di 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>"
}
]
}Usa questa route per modificare immagini esistenti con upload multipart compatibili con OpenAI su CometAPI.
Usa questa route quando
- Hai già un’immagine sorgente e vuoi una modifica guidata da prompt
- Potresti aver bisogno di una mask per modifiche mirate
- Puoi gestire l’upload di file multipart invece di una semplice richiesta JSON
Primo percorso di validazione
- Inizia con un file PNG o JPG
- Salta la mask finché il flusso base di modifica non funziona
- Usa una singola istruzione breve che richieda un solo cambiamento visibile
- Aspettati una latenza più lunga rispetto alla normale generazione di immagini
Comportamento del modello
gpt-image-1,gpt-image-1-miniegpt-image-1.5sono gestiti al meglio come route di modifica orientate prima di tutto a base64dall-e-3può restituire output URL quando il percorso del provider lo supportaqwen-image-editsegue il comportamento di modifica specifico del provider dietro la stessa route CometAPI
La validazione live del 2026-03-13 ha confermato che una richiesta PNG basata su
gpt-image-1 è andata a buon fine quando è stato consentito un timeout più lungo. La risposta ha restituito usage.input_tokens, usage.output_tokens, usage.total_tokens e un payload data[0].b64_json.Autorizzazioni
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.
Esempio:
"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.
Opzioni disponibili:
high, medium, low Requested output format when supported by the selected model.
Opzioni disponibili:
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>"
}
]
}