/v1/images/edits

Görselleri AI ile düzenleyin

OpenAI uyumlu API kullanarak metin komutlarıyla görselleri düzenleyin ve değiştirin. Tekli ve çoklu görsel girişlerini destekler.

POST/v1/images/edits

İstek Örnekleri

cURL (Multipart)

curl https://api.ustagpt.com.tr/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-1.5" \
  -F "[email protected]" \
  -F "prompt=Add a red hat to the person in the image" \
  -F "size=1024x1024"

Parametreler

Ad	Tip	Gerekli	Açıklama
model	string	Evet	Kullanılacak model ID'si (örn: gpt-image-1.5)
image	file \| string \| array	Evet	Düzenlenecek görsel dosya(lar)ı. Tekli dosya, dosya dizisi veya base64 kodlu görselleri destekler
prompt	string	Evet	İstenen düzenlemenin metin açıklaması
mask	file	Hayır	Düzenlenecek alanları gösteren şeffaf bölgeli PNG dosyası
n	integer	Hayır	Oluşturulacak görsel sayısı (varsayılan: 1)
size	string	Hayır	Görsel boyutu (örn: 1024x1024, 1536x1024, 1024x1536)
quality	string	Hayır	Görsel kalitesi: auto, high, medium veya low
background	string	Hayır	Arka plan tipi: transparent, opaque veya auto
output_format	string	Hayır	Çıktı formatı: png, jpeg veya webp
response_format	string	Hayır	Yanıt formatı: url veya b64_json

Desteklenen Modeller

gpt-image-1.5

Gelişmiş düzenleme yeteneklerine sahip en yeni GPT görsel modeli

gpt-image-1

İyi düzenleme desteğine sahip GPT görsel modeli

nano-banana-pro

Düzenleme yönergelerini güçlü biçimde takip eden Google görsel modeli

flux.2-pro

Black Forest Labs modeli; yerel düzenlemelerde hızlı ve isabetli

qwen-image-2

Görsellerde metin oluşturma yeteneği iyi olan Alibaba modeli

Yanıt

Response

{
  "created": 1713833628,
  "data": [
    {
      "url": "https://api.ustagpt.com.tr/images/abc123.png"
    }
  ]
}

Önemli Notlar

Bu endpoint dosya yüklemeleri için multipart/form-data isteklerini kabul eder
GPT görsel modelleri image[] formatını kullanarak istek başına 16 görsele kadar destekler
Her görsel dosyası 50MB'den küçük olmalıdır
Desteklenen görsel formatları: PNG, WebP, JPG