Nano Banana 2 API Teknik Rehberi

Gelişmiş yapay zeka yeteneklerini kullanan Nano Banana 2 Görsel Üretim Servisi için detaylı teknik belgeler

Fiyatları GörüntüleNano Banana 2 abonelik seçeneklerini keşfedin

Nano Banana 2 API'ye Giriş

Nano Banana 2 Görsel Üretim API'si, metin açıklamalarından ve örnek grafiklerden premium görseller oluşturmak için gelişmiş yapay zeka sistemleriyle entegrasyon sağlar. Nano Banana 2 platformumuz, kapsamlı iş koordinasyonu ve bildirim yetenekleri sunan basit bir REST mimarisi sunar.

Nano Banana 2 Temel Yetenekleri

  • En son yapay zeka sistemlerini kullanan Nano Banana 2 metinden görsele dönüşüm
  • Nano Banana 2 örnek grafiklerle uyumluluk (maksimum 4 görsel)
  • İlerleme izleme ile Nano Banana 2 engelsiz iş yürütme
  • Anlık durum güncellemeleri için Nano Banana 2 webhook entegrasyonu
  • JSON formatında yanıtlar sunan Nano Banana 2 REST mimarisi
  • Nano Banana 2 Bearer kimlik doğrulama sistemi

overview.base_url

https://api.defapi.org

overview.api_version

v1.0.0

Nano Banana 2 Uygulama Kılavuzu

  1. 1. Ana platformumuz üzerinden Nano Banana 2 API kimlik bilgileriniz için kayıt olun
  2. 2. Nano Banana 2 erişim tokeninizi Authorization parametresine ekleyin
  3. 3. Nano Banana 2 görsel oluşturma terminaline POST gönderimi yapın
  4. 4. Durum doğrulama için sağlanan Nano Banana 2 iş tanımlayıcısını kullanın
  5. 5. Görev tamamlandığında Nano Banana 2 üretilmiş görsellerinizi alın

Kimlik Doğrulama

Her API isteği Bearer token doğrulaması gerektirir. Her iletimde Authorization parametresine erişim bilgilerinizi ekleyin.

Doğrulama Yöntemi

HTTP Bearer token doğrulamasını Authorization parametresine erişim bilgilerinizi ekleyerek uygulayın:

Authorization: Bearer <your-api-key>

Örnek Erişim Anahtarı Yapısı

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"
  }'

Başarılı Doğrulama

  • Erişim bilgileri güncel
  • Müşteri kaydı aktif durumda
  • Yeterli hizmet kredisi mevcut

Sık Karşılaşılan Sorunlar

  • Erişim bilgileri eksik
  • Yanlış erişim anahtarı yapılandırması
  • Devre dışı veya askıya alınmış kayıt

Nano Banana 2 Görsel Üretim API

Gelişmiş yapay zeka sistemleri ve uyarlanabilir metin talimatları ile örnek görüntüler kullanarak Nano Banana 2 ile görseller oluşturun.

Bağlantı 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

Uygulama Örnekleri

Temel Nano Banana 2 Görsel Oluşturma

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

Örnek Grafikler ile Nano Banana 2 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"
}

Çıktı Yapısı

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

Sorun Yönetimi

400 - Bad Request

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

401 - Unauthorized

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

Nano Banana 2 İş Durumu API

Nano Banana 2 görsel üretim terminalinin sağladığı görev kimliğini kullanarak Nano Banana 2 görsel üretim işlerinin ilerlemesini ve sonuçlarını araştırın.

Bağlantı Terminali

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

Araştırma Değişkenleri

ParameterTypeRequiredDescription
task_idstringYesUnique task identifier returned from generation endpoint

Gönderim Ö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 2 İş Durumu Kategorileri

pending - Nano Banana 2 işi başlatıldı, işleme başlatılması bekleniyor
submitted - Nano Banana 2 işi üretim sırasına girdi
in_progress - Nano Banana 2 işi şu anda aktif işlem görüyor
success - Nano Banana 2 işi başarıyla tamamlandı ve görseller üretildi
failed - Nano Banana 2 işi teknik komplikasyonlar nedeniyle sonlandırıldı

Sorun Yanıtları

404 - Task Not Found

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

401 - Unauthorized

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

Nano Banana 2 Bilgi Yapıları

API iletişimlerinde ve gönderimlerinde kullanılan tüm Nano Banana 2 bilgi konfigürasyonları ve şablonları için kapsamlı dokümantasyon.

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 2 Desteklenen Konfigürasyonlar

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

Hata Yönetimi

Karmaşıklıkları yönetmek ve API yanıt göstergelerini yorumlamak için kapsamlı kılavuz. Tüm hata bildirimleri etkili çözüm metodolojilerine olanak sağlayan standart formatta hazırlanmıştır.

HTTP Yanıt Göstergeleri

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 Çözümü Önerilen Yaklaşımlar

  1. Çıktı içeriğini analiz etmeden önce her zaman HTTP yanıt göstergelerini kontrol edin
  2. 500 hatalarında yeniden deneme mekanizmaları için aşamalı gecikme algoritmaları kullanın
  3. Sorun giderme için hata bildirimlerini ayrıntılı şekilde belgelendirin
  4. 400 hatalarını önlemek için istek göndermeden önce girdi geçerliliğini doğrulayın
  5. Müşterilerden API kimlik bilgisi güncellemeleri isteyerek kimlik doğrulama sorunlarını çözün
  6. Aşırı durum sorgulamaları yerine makul aralıklarla iş ilerlemesini takip edin
  7. Sürekli tamamlanma izlemesini ortadan kaldırmak için mümkün olduğunda webhook entegrasyonu 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;
  }
}