Referansv1.0.0 Kararlı

AI Image 2 API

GPT Image 2.0 görsel oluşturma ve referans tabanlı düzenlemeyi entegre edin. Bu dokümantasyon kimlik doğrulama, generate ve status uç noktaları, istek limitleri ve faturalandırmayı kapsar.

https://gptimage2-ai.com

Hızlı başlangıç

İlk API çağrınızı yalnızca iki adımda tamamlayın: bir üretim görevi gönderin ve ardından durumu sorgulayın.

Görev gönder

Bir görev kimliği (Task ID) almak için generate uç noktasına POST isteği gönderin.

Durumu sorgula

Görsel URL’sini alana kadar ilerlemeyi kontrol etmek için görev kimliğini kullanın.

Kimlik doğrulama

Not: Lütfen API anahtarınızı güvenli tutun ve istemci tarafı kodda ortaya çıkarmayın.

HTTP başlığı

Authorization: Bearer {YOUR_API_KEY}

POST

https://gptimage2-ai.com/api/generate

Yeni bir görsel oluşturma veya referans düzenleme görevi başlatır. Bu uç nokta asenkron çalışır ve task_id ile başlangıç durumunu döndürür; son görselleri /api/status ile alın.

This endpoint responds immediately with task_id. Poll /api/status until the status becomes SUCCESS to obtain image URLs.

Gövde parametreleri

Parametre adı	Tür	Zorunlu	Açıklama
`prompt`	string	Koşullu	Oluşturulacak görseli tanımlayan metin istemi (en fazla 20000 karakter). images boşken zorunludur.
`images`	string[]	Hayır	Saf metinden görsel yerine düzenleme veya yeniden birleştirme için referans görsel URL dizisi (isteğe bağlı).
`aspect_ratio`	string	Hayır	Çıktı en-boy oranı. İzin verilen değerler: auto, 1:1, 5:4, 9:16, 21:9, 16:9, 4:3, 3:2, 4:5, 3:4, 2:3.
`resolution`	string	Hayır	Çıktı çözünürlüğü: 1K (varsayılan), 2K veya 4K. 5:4 ve 4:5 yalnızca 1K destekler; 1:1 4K desteklemez.

Yanıt (JSON)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_1234567890",
    "status": "IN_PROGRESS"
  }
}

GET

https://gptimage2-ai.com/api/status

Bir görevin yürütme durumunu ve sonuçlarını sorgular.

Sorgu parametreleri

Parametre adı	Zorunlu	Açıklama
`task_id`	Evet	Görev gönderilirken döndürülen kimlik.

Yanıt örneği

{
  "code": 200,
  "message": "success",
  "data": {
    "status": "SUCCESS",
    "task_id": "xxxxxxxx",
    "request": {
      "prompt": "A beautiful sunset over mountains",
      "aspect_ratio": "16:9"
    },
    "response": [
      "https://cdn.example.com/images/task_xxx_0"
    ],
    "consumed_credits": 10,
    "created_at": "2025-12-05 13:05:09",
    "error_message": null
  }
}

Faturalandırma

Görsel başına maliyet

10 kredi / görsel

Başarısız görevler ücretlendirilmez. Sitedeki diğer modeller kendi kredi oranlarını kullanır.

Hata yönetimi

401 UnauthorizedGeçersiz API anahtarı
402 Payment RequiredYetersiz bakiye
429 Too Many RequestsÇok fazla istek

GPT Image 2.0 hakkında

GPT Image 2.0, AI Image 2’nin arkasındaki görsel modelidir. AI Image 2 bağımsız bir hizmettir; OpenAI ile bağlantılı, onaylı veya sponsorlu değildir.

GPT Image 2.0 — isteme sadık üretim ve görselde okunabilir metin

GPT Image 2.0 ayrıntılı talimatları yakından izler, görsellerin içinde okunabilir metin işler ve mevcut bir fotoğrafı düzenlemek için referans fotoğrafları kabul eder.

Tipografi, düzen ve referans düzenleme için üretildi

Metnin okunabilir kalması gereken posterler, infografikler ve arayüz maketlerinde başarılıdır; referans görseller sağlandığında stil veya arka plan değişse de nesneyi korur.

Güçlü yönleri

Görselde okunabilir metin — poster ve infografiklerde başlıklar, etiketler ve kısa sloganlar işler.
Referans tabanlı düzenleme — nesneyi koruyarak fotoğrafı yeniden stillendirmek veya birleştirmek için görsel URL’leri verin.
Yapılandırılmış düzenler — menüler, el ilanları ve sıralı panelli storyboard’lar gibi çok öğeli kompozisyonlar.
1K’dan 4K’ya çıktı — 1K, 2K veya 4K seçin; 1:1’de 4K yok, 5:4 / 4:5 yalnızca 1K.
On bir en-boy oranı — auto, 1:1, 5:4, 9:16, 21:9, 16:9, 4:3, 3:2, 4:5, 3:4 ve 2:3.
Sabit ücret — her görsel 10 kredi, yalnızca görev başarılı olduğunda düşülür.

Nasıl kullanılır

promptprompt — doğal dil açıklaması; işlenecek tam metni yazın (en fazla 20000 karakter).
imagesimages — isteğe bağlı referans görsel URL dizisi; model bunları düzenler veya yeniden birleştirir.
resolutionresolution — 1K (varsayılan), 2K veya 4K; her boyut aynı 10 krediye mal olur.

GPT Image 2 prompts Examples