API’ye Giriş Hızlı Başlangıç Nano Banana Pro Nano Banana 2 Nano Banana 2 Lite

Başlarken

Hızlı Başlangıç

Bearer token, JSON istek gövdesi ve iki production endpoint olan create ve check ile Nano Banana API’yi kullanmaya başlayın.

Gerekenler

AKullanılabilir kredisi bulunan bir Nano Banana hesabı
API Anahtarları panelinden oluşturulmuş bir API anahtarı

API Anahtarınızı Alın

Oturum açın, API Anahtarları sayfası sayfasını açın, bir anahtar adı girin ve Oluştur’a tıklayın. Anahtarı hemen kopyalayın; tam anahtar yalnızca bir kez gösterilir.

HTTP İstek Header’ını Yapılandırın

Base URL

HTTPS

https://nanobanana.io

HTTP

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Hızlı Başlangıç

Asenkron bir üretim görevi oluşturmak için JSON payload gönderin. Döndürülen task_id değerini kaydedin ve görev durumunu kontrol etmek için kullanın.

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",
  "input": {
    "prompt": "Fütüristik muz şeklinde bir kameranın sinematik ürün fotoğrafı",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}'

Yanıt

{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

Görev Oluştur

Asenkron bir üretim görevi oluşturmak için bir model ID ve input nesnesi gönderin. Bu endpoint görevin kuyruğa alındığını doğrular; nihai medya sonucunun tamamlanmasını beklemez.

POST/api/v1/create

Yetkilendirmeler

Alan

Tür

zorunlu

Açıklama ve kısıtlamalar

Authorizationstringzorunlu

İstek header’ında Bearer token olarak gönderilen API anahtarı. Örnek: Authorization: Bearer sk_live_your_api_key

İstek gövdesi

application/json

Alan

Tür

zorunlu

Açıklama ve kısıtlamalar

modelstringzorunlu

Herkese açık model ID. API bölümünde listelenen bir modeli kullanın; örneğin nano-banana-2.

inputobjectzorunlu

Üretim girdisi. Boş olmayan bir prompt içermelidir. Diğer input alanları modele özeldir; görüntüler, en-boy oranı, süre, çözünürlük veya adet gibi alanları göndermeden önce ilgili model dokümantasyonuna bakın.

JSON

{
  "model": "nano-banana-2",
  "input": {
    "prompt": "Fütüristik muz şeklinde bir kameranın sinematik ürün fotoğrafı",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}

Oluşturma yanıtı

application/json

Başarılı bir yanıt görev ID’sini, model ID’sini, kuyruk durumunu ve bu görev için ayrılan kredi sayısını döndürür.

HTTP 201

{
  "data": {
    "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617",
    "model": "nano-banana-2",
    "status": "processing",
    "credits": 20
  }
}

Görev Durumunu Al

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

İstek gövdesi

application/json

Alan

Tür

zorunlu

Açıklama ve kısıtlamalar

task_idstringzorunlu

POST /api/v1/create tarafından döndürülen görev ID’si. Görev durumunu ve nihai sonuç URL’lerini almak için bu ID’yi kullanın.

JSON

{
  "task_id": "d0a8d9f2-5e01-4c5d-9f40-38d197a1c617"
}

Durum yanıtı

application/json

İşleme tamamlandığında yanıt nihai sonuç URL’lerini ve zamanlama meta verilerini içerir. Görev çalışmaya devam ederken data şu şekilde döndürülür: null.

HTTP 200

{
  "id": "adc0e6ec-9c12-44fc-b45f-112187766c3",
  "created_at": 1788652800,
  "model": "nano-banana-2",
  "status": "completed",
  "data": {
    "results": [
      "https://cdn.nanobanana.io/api/predictions/example.mp4"
    ],
    "processing_time": 48
  }
}