Skip to main content
POST
Gunakan rute ini untuk mengedit gambar yang sudah ada dengan upload multipart yang kompatibel dengan OpenAI di CometAPI.

​
Gunakan rute ini ketika

  • Anda sudah memiliki gambar sumber dan ingin melakukan edit berbasis prompt
  • Anda mungkin memerlukan mask untuk perubahan yang ditargetkan
  • Anda dapat menangani upload file multipart alih-alih permintaan JSON biasa

​
Permintaan pertama yang aman

  • Mulai dengan satu file PNG atau JPG
  • Lewati mask sampai alur edit dasar berfungsi
  • Gunakan model: "gpt-image-2" untuk permintaan edit gambar GPT pada rute ini
  • Gunakan satu instruksi singkat yang meminta satu perubahan yang terlihat
  • Baca hasil edit dari data[0].b64_json
  • Setel output_format: "jpeg" saat Anda menginginkan payload JPEG
  • Harapkan latensi yang lebih lama dibandingkan pembuatan gambar biasa

​
Perilaku model

  • Model edit gambar GPT pada rute ini mengembalikan data gambar base64 inline
  • output_format mengontrol tipe gambar yang dienkode di dalam b64_json
  • response_format hanya penting ketika model mendukung output URL
  • qwen-image-edit mengikuti perilaku edit khusus penyedia di balik rute CometAPI yang sama

Otorisasi

​
Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data
​
image
file
wajib

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

​
prompt
string
wajib

Edit instruction describing the change you want.

Contoh:

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

​
model
string
default: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
default:1

Number of edited images to return.

​
quality
enum<string>

Quality setting for models that support it.

Opsi yang tersedia:
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.

Opsi yang tersedia:
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.

Contoh:

"jpeg"

​
size
string

Requested output size when supported by the selected model.

Respons

200 - application/json

Edited image result.

​
created
integer
wajib
​
usage
object
wajib
​
data
object[]
wajib
​
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.