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.

Son değiştirilme tarihi 23 Haziran 2026