Referensi API
Panduan Integrasi
Kesalahan
Harga & Penagihan
OpenAI
Image Editing dengan GPT-Image-1
Gunakan POST /v1/images/edits dengan gpt-image-1 di CometAPI untuk mengedit gambar melalui mask, prompt, dan opsi size, selaras dengan perilaku edit gambar 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>"
}
]
}Gunakan route ini untuk mengedit gambar yang sudah ada dengan upload multipart yang kompatibel dengan OpenAI di CometAPI.
Gunakan route ini saat
- Anda sudah memiliki gambar sumber dan menginginkan edit berbasis prompt
- Anda mungkin memerlukan mask untuk perubahan yang ditargetkan
- Anda dapat menangani upload file multipart alih-alih request JSON biasa
Jalur validasi pertama
- Mulai dengan satu file PNG atau JPG
- Lewati mask sampai alur edit dasar berfungsi
- Gunakan satu instruksi singkat yang meminta satu perubahan yang terlihat
- Harapkan latensi yang lebih lama dibandingkan generasi gambar biasa
Perilaku model
gpt-image-1,gpt-image-1-mini, dangpt-image-1.5paling baik diperlakukan sebagai route edit yang mengutamakan base64dall-e-3dapat mengembalikan output URL ketika jalur provider mendukungnyaqwen-image-editmengikuti perilaku edit khusus provider di balik route CometAPI yang sama
Validasi langsung pada 2026-03-13 mengonfirmasi bahwa request
gpt-image-1 berbasis PNG berhasil saat diberi timeout yang lebih panjang. Respons mengembalikan usage.input_tokens, usage.output_tokens, usage.total_tokens, dan payload data[0].b64_json.Otorisasi
Bearer token authentication. Use your CometAPI key.
Body
multipart/form-data
Source image file. Start with one PNG or JPG input for the simplest flow.
Edit instruction describing the change you want.
Contoh:
"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.
Opsi yang tersedia:
high, medium, low Requested output format when supported by the selected model.
Opsi yang tersedia:
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>"
}
]
}