API

Nano Banana 2 Lite API

Görüntü

Nano Banana 2 Lite API; güvenilir karakter tutarlılığı, akıcı çoklu görüntü birleştirme ve doğal dil ile düzenleme özellikleriyle günlük yaratıcı iş akışları için hızlı ve verimli görüntü üretimi sunar. Hafif ve yüksek kaliteli görsel üretim için Nano Banana 2 Lite API’yi entegre edin.

Yetkilendirmeler

Bearerstringheaderzorunlu

İstekleri yetkilendirmek için API anahtarı

Gövde

application/json

modelstringzorunlu

nano-banana-2-lite

input.promptstringzorunlu

Oluşturmak istediğiniz görüntüyü veya referans görüntülerinizde yapmak istediğiniz değişiklikleri açıklayın. Baştaki ve sondaki boşluklar temizlenir.

Maksimum uzunluk: 5.000 karakter

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.

Maksimum öğe sayısı: 14

input.aspect_ratiostringisteğe bağlı

Çıktının genişlik-yükseklik oranı. Auto seçeneği modelin karar vermesini sağlar.

Varsayılan: auto

auto1:12:33:23:44:34:55:49:1616:921:91:44:11:88:1

İ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": "nano-banana-2-lite",
  "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": "nano-banana-2-lite",
    "status": "processing",
    "credits": 18
  }
}

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": "nano-banana-2-lite",
    "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": "nano-banana-2-lite",
    "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ı.
Oluşturma	İstek başına kredi
Tek görsel	18

İ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.