API

GPT Image 2.5 API

Görüntü

GPT Image 2.5 API, OpenAI’ın en gelişmiş görsel oluşturma ve düzenleme modellerini uygulamanıza taşır. Metinden görseller oluşturun veya referans görselleri düzenleyin; esnek en-boy oranları ve 1K, 2K ya da 4K çıktılar kullanın. Hızlı ve yüksek kaliteli günlük üretim için flare, zorlu yaratıcı çalışmalar ve hassas düzenleme için sunburst seçin.

Yetkilendirmeler

Bearerstringheaderzorunlu

İstekleri yetkilendirmek için API anahtarı

Gövde

application/json

modelstringzorunlu

gpt-image-2-5

input.promptstringzorunlu

Oluşturmak istediğiniz görseli; konu, kompozisyon, stil ve ışıklandırma ile birlikte açıklayın. Düzenleme yaparken referans görsellerde nelerin değişeceğini ve korunacağını belirtin. Baştaki ve sondaki boşluklar kaldırılır.

input.modestringisteğe bağlı

GPT Image 2.5 varyantını seçin. flare varsayılan moddur ve yüksek kaliteli günlük üretim ile hızlı yinelemeler için hıza öncelik verir. sunburst, yüksek kalite gereksinimlerine ve düzenleme hassasiyetine öncelik verir; referans görsellerde doğru değişikliklerin önemli olduğu işler için uygundur.

Her iki mod da metinden görsel oluşturmayı ve görsel düzenlemeyi destekler. Metinden üretim için input.images alanını atlayın, düzenleme için referans görseller sağlayın. Modları karşılaştırırken aynı istemi, referansları, en-boy oranını ve çözünürlüğü kullanın.

Varsayılan: flare

flaresunburst

input.imagesstring[]isteğe bağlı

İsteğe bağlı referans görsel URL’leri. Yalnızca herkese açık HTTPS URL’lerini kullanın. Metinden görsel oluşturmak için bu alanı atlayın.

input.aspect_ratiostringisteğe bağlı

Çıktı görselinin genişlik-yükseklik oranı. auto, modelin uygun bir kompozisyon seçmesini sağlar. Biçimi belirlemek için listedeki oranlardan birini seçin: kare için 1:1, dikey için 9:16 veya yatay için 16:9.

Varsayılan: auto

auto1:12:33:23:44:39:1616:921:9

input.resolutionstringisteğe bağlı

Çıktı çözünürlüğü seviyesi. İlgili seviyeyi seçmek için küçük harfli 1k, 2k veya 4k değerlerini kullanın. Belirli bir çıktı çözünürlüğü gerektiğinde bu alanı açıkça ayarlayın.

Varsayılan: 2k

1k2k4k

İstek örnekleri

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2-5",
  "input": {
    "prompt": "Fütüristik muz şeklinde bir kameranın sinematik ürün fotoğrafı"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "gpt-image-2-5",
    "status": "processing",
    "credits": 5
  }
}

Görev tamamlanana veya başarısız olana kadar döndürülen görev ID’si ile bu endpoint’i poll edin. En güncel görev durumunu kontrol etmek için her 5 saniyede bir polling yapmanızı öneririz.

POST /api/v1/check

{
  "task_id": "task_example"
}

Yanıt

POST /api/v1/check tarafından döndürülen görev durumu. Aşağıdaki kimlikler, URL’ler ve zaman damgaları örnektir.

idstringzorunlu

data.id içindeki görev kimliği, sorgu isteğinde kullanılan task_id ile aynıdır.

statusstringzorunlu

completed, üretimin başarılı olduğunu ve data.data alanının sonuçları içerdiğini belirtir. Diğer durumlarda data.data null olur.

failed_reasonstringisteğe bağlı

Yalnızca status failed olduğunda hata nedenini açıklamak için döndürülür. completed ve processing durumlarında bu alan bulunmaz.

Tamamlandı · completed

İndirme URL’leri data.data.results içindedir.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

Diğer durumlar

processing veya failed durumunda data.data null olur. Bu örnek failed durumunu gösterir: yalnızca failed, failed_reason içerir. processing için sorgulamaya devam edin; failed için durdurun.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

Kredi tüketimi

Tek bir görsel oluşturan isteğin tükettiği kredi miktarı.

Tek bir görsel oluşturan isteğin tükettiği kredi miktarı.
Çözünürlük	1K	2K	4K
Tek görsel	12	36	50

İsteğe bağlı parametreler belirtilmedi: 5 kredi

İlgili ücreti kullanmak için listelenen input parametrelerini açıkça belirtin. Birden fazla görsel oluşturan istekler daha fazla kredi tüketebilir.

POST /api/v1/create yanıtındaki credits alanı, görev için kesilen kredi miktarını gösterir.