Nano Banana Pro API

Nano Banana Pro API Geliştirici Referansı

Gelişmiş makine öğrenimi teknolojileriyle desteklenen Nano Banana Pro API Görsel Üretim Platformu için eksiksiz geliştirici referans kılavuzu

Fiyatlandırmayı GörüntüleNano Banana Pro API abonelik planlarını keşfedin

Nano Banana Pro API Genel Bakış

Nano Banana Pro API Görsel Üretim hizmeti, geliştiricilerin metin promptları ve referans fotoğraflardan yüksek kaliteli görseller üretmesi için gelişmiş makine öğrenimi motorlarına bağlanmasını sağlar. Çözümümüz, kapsamlı görev yönetimi ve gerçek zamanlı bildirim özelliklerine sahip basit bir REST arayüzü sunar.

Nano Banana Pro API Özellikleri

  • • Nano Banana Pro API, en gelişmiş makine öğrenimi motorları ile metinden görsel oluşturma.
  • • Nano Banana Pro API referans görsel desteği (en fazla 4 referans görseli).
  • • Nano Banana Pro API, gerçek zamanlı ilerleme takibi ile zaman uyumsuz görev işleme.
  • • Nano Banana Pro API, anında durum değişiklikleri için webhook bildirimleri.
  • • Nano Banana Pro API, yapılandırılmış JSON veri döndüren RESTful arayüz.
  • • Nano Banana Pro API Bearer token kimlik doğrulama mekanizması.

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Nano Banana Pro API Hızlı Başlangıç

  1. 1. Resmi web sitemizden hesap oluşturun ve erişim bilgilerinizi alın.
  2. 2. Nano Banana Pro API kimlik doğrulama token'ınızı Authorization başlığına ekleyin.
  3. 3. Nano Banana Pro API görsel oluşturma uç noktasına bir POST isteği gönderin.
  4. 4. İşlem durumunu kontrol etmek için dönen görev kimliğini (task ID) kullanın.
  5. 5. İşlem tamamlandığında oluşturulan Nano Banana Pro API görsellerinizi alın.

Erişim Kimlik Doğrulaması

Tüm API istekleri, Bearer token kimlik bilgileri kullanılarak geçerli kimlik doğrulaması içermelidir. Her istek için API anahtarınızı Authorization başlığına ekleyin.

Kimlik Doğrulama Yöntemi

API kimlik bilgilerinizi Authorization başlığına ekleyerek HTTP Bearer token kimlik doğrulamasını kullanın:

Authorization: Bearer <your-api-key>

Örnek API Anahtarı Formatı

Authorization: Bearer dk-1234567890abcdef

İstek Örneği

curl -X POST "https://api.defapi.org/api/image/gen" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key-here" \
  -d '{
    "model": "google/gempix2",
    "prompt": "A beautiful landscape"
  }'

Geçerli Kimlik Doğrulaması

  • ✅ API kimlik bilgilerinin süresi dolmamış
  • ✅ Hesap kaydı iyi durumda
  • ✅ Yeterli hesap bakiyesi mevcut

Yaygın Sorunlar

  • ❌ İstekte API kimlik bilgileri eksik
  • ❌ Geçersiz veya yanlış formatlanmış API anahtarı
  • ❌ Hesap devre dışı veya hesap erişimi iptal edilmiş

Nano Banana Pro API Resim Üretimi

Nano Banana Pro API'yi kullanarak, gelişmiş makine öğrenimi teknolojileri ve esnek metin prompt'ları ile referans resimler eşliğinde resimler oluşturun.

API Uç Noktası

POST /api/image/gen

İstek Parametreleri

ParameterTypeRequiredDescription
modelstringYesModel identifier (e.g., "google/gempix2")
promptstringYesText prompt describing the image
imagesarrayNoReference image URLs (max 4)
callback_urlstringNoWebhook URL for completion notifications

Kullanım Örnekleri

Temel Nano Banana Pro API Resim Oluşturma

{
  "model": "google/gempix2",
  "prompt": "A beautiful girl dancing in a garden"
}

Örnek Resimlerle Nano Banana Pro API Referans Tabanlı Üretim

{
  "model": "google/gempix2",
  "prompt": "Put them in a basket",
  "images": [
    "https://cdn.openai.com/API/docs/images/body-lotion.png",
    "https://cdn.openai.com/API/docs/images/soap.png"
  ],
  "callback_url": "https://example.com/webhook/image-callback"
}

Yanıt Formatı

{
  "code": 0,
  "message": "ok",
  "data": {
    "task_id": "ta12345678-1234-1234-1234-123456789abc"
  }
}

Hata Yönetimi

400 - Bad Request

{"code": 1, "message": "failed", "detail": "prompt is required"}

401 - Unauthorized

{"code": 1, "message": "Invalid API key"}

Nano Banana Pro API Görev Durumu

Nano Banana Pro API resim oluşturma uç noktası tarafından döndürülen görev kimliğini kullanarak Nano Banana Pro API resim oluşturma görevlerinin durumunu ve sonuçlarını sorgulayın.

API Uç Noktası

GET /api/task/query?task_id=<task_id>

Sorgu Parametreleri

ParameterTypeRequiredDescription
task_idstringYesUnique task identifier returned from generation endpoint

İstek Örneği

curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \
  -H "Authorization: Bearer your-api-key-here"

Nano Banana Pro API Görev Durum Türleri

pending - Nano Banana Pro API görevi oluşturuldu ve işleme başlamak için bekliyor
submitted - Nano Banana Pro API görevi üretim için kuyruğa alındı
in_progress - Nano Banana Pro API görevi şu anda işleniyor
success - Nano Banana Pro API görevi başarıyla tamamlandı ve oluşturulan resimler hazır
failed - Nano Banana Pro API görevi bir hatayla karşılaştı ve tamamlanamadı

Hata Yanıtları

404 - Task Not Found

{"code": 1, "message": "task not found"}

401 - Unauthorized

{"code": 401, "message": "Invalid API key"}

Nano Banana Pro API Veri Yapıları

API isteklerinde ve yanıtlarında kullanılan tüm Nano Banana Pro API veri formatları ve şemaları için eksiksiz başvuru.

ImageGenResult

Represents a generated image result.

{
  "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}
FieldTypeDescription
imagestringImage URL or base64 data URI

CallbackPayload

Payload sent to the callback_url when task status changes to final states.

{
  "result": [
    {
      "image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
    }
  ],
  "status": "success",
  "task_id": "ta5c9705-b8ae-4cb9-aa6f-97c4fee88c8d",
  "consumed": "0.500000",
  "status_reason": {
    "message": null
  }
}
FieldTypeDescription
resultarrayArray of ImageGenResult objects (null if failed)
statusstringFinal task status (success/failed)
task_idstringUnique task identifier
consumedstringCredits consumed by the task
status_reasonobjectStatus details including error message if failed

Nano Banana Pro API Desteklenen Modeller

google/gempix2Nano Banana image generation model
google/gemini-2.5-flash-imageGemini 2.5 Flash image model

Hata Yönetimi

Hataları işleme ve API yanıt kodlarını yorumlama için eksiksiz rehber. Tüm hata mesajları, etkili sorun giderme için tutarlı bir formattadır.

HTTP Durum Kodları

200

OK

Request was successful

400

Bad Request

Invalid request parameters or malformed JSON

401

Unauthorized

Invalid, missing, or expired API key

404

Not Found

Task not found or endpoint doesn't exist

500

Internal Server Error

Server-side error occurred

Hata Yönetimi En İyi Uygulamaları

  1. Yanıt verilerini işlemeden önce her zaman HTTP durum kodlarını kontrol edin.
  2. 500 hatalarında yeniden deneme için üstel geri alma stratejisi kullanın.
  3. Hata ayıklama amacıyla, hata mesajlarını tam bağlamı ile kaydedin.
  4. 400 hatalarını önlemek için, istek göndermeden önce giriş parametrelerini doğrulayın.
  5. Kimlik doğrulama sorunlarını çözmek için istemcilerin API kimlik bilgilerini yenilemesini sağlayın.
  6. Durumu aşırı sık sorgulamak yerine, görev ilerlemesini makul aralıklarla izleyin.
  7. Sürekli durum sorgulamasından kaçınmak için, mümkün olduğunda webhook bildirimlerini kullanın.

Örnek Hata Yönetimi (JavaScript)

async function generateImage(prompt, apiKey) {
  try {
    const response = await fetch('https://api.defapi.org/api/image/gen', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        model: 'google/gempix2',
        prompt: prompt
      })
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API Error ${response.status}: ${errorData.message}`);
    }

    const data = await response.json();
    return data.data.task_id;

  } catch (error) {
    console.error('Image generation failed:', error.message);
    throw error;
  }
}