Skip to main content
POST
CometAPI üzerinde OpenAI uyumlu multipart yüklemelerle mevcut görüntüleri düzenlemek için bu route’u kullanın.

​
Bu route’u şu durumlarda kullanın

  • Zaten bir kaynak görüntünüz varsa ve prompt odaklı bir düzenleme istiyorsanız
  • Hedefe yönelik değişiklikler için bir maskeye ihtiyaç duyabiliyorsanız
  • Düz bir JSON isteği yerine multipart dosya yüklemeyi kullanabiliyorsanız

​
Güvenli ilk istek

  • Tek bir PNG veya JPG dosyasıyla başlayın
  • Temel düzenleme akışı çalışana kadar maskeyi atlayın
  • Bu route üzerindeki GPT image düzenleme istekleri için model: "gpt-image-2" kullanın
  • Görünür tek bir değişiklik isteyen kısa bir talimat kullanın
  • Düzenlenmiş sonucu data[0].b64_json içinden okuyun
  • JPEG payload istediğinizde output_format: "jpeg" ayarlayın
  • Düz görüntü oluşturmaya kıyasla daha uzun gecikme bekleyin

​
Model davranışı

  • Bu route üzerindeki GPT image düzenleme modelleri satır içi base64 görüntü verisi döndürür
  • output_format, b64_json içindeki kodlanmış görüntü türünü kontrol eder
  • response_format yalnızca bir model URL çıktısını desteklediğinde önemlidir
  • qwen-image-edit, aynı CometAPI route’u arkasında sağlayıcıya özgü düzenleme davranışını izler

Yetkilendirmeler

​
Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

multipart/form-data
​
image
file
gerekli

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

​
prompt
string
gerekli

Edit instruction describing the change you want.

Örnek:

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

​
model
string
varsayılan: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
varsayılan:1

Number of edited images to return.

​
quality
enum<string>

Quality setting for models that support it.

Mevcut seçenekler:
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.

Mevcut seçenekler:
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.

Örnek:

"jpeg"

​
size
string

Requested output size when supported by the selected model.

Yanıt

200 - application/json

Edited image result.

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