Nano Banana 2 API Teknik Rehberi
Gelişmiş yapay zeka yeteneklerini kullanan Nano Banana 2 Görsel Üretim Servisi için detaylı teknik belgeler
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.orgoverview.api_version
v1.0.0Nano Banana 2 Uygulama Kılavuzu
- 1. Ana platformumuz üzerinden Nano Banana 2 API kimlik bilgileriniz için kayıt olun
- 2. Nano Banana 2 erişim tokeninizi Authorization parametresine ekleyin
- 3. Nano Banana 2 görsel oluşturma terminaline POST gönderimi yapın
- 4. Durum doğrulama için sağlanan Nano Banana 2 iş tanımlayıcısını kullanın
- 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
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | Model identifier (e.g., "google/gempix2") |
| prompt | string | Yes | Text prompt describing the image |
| images | array | No | Reference image URLs (max 4) |
| callback_url | string | No | Webhook 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
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | Yes | Unique 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ı bekleniyorsubmitted - Nano Banana 2 işi üretim sırasına girdiin_progress - Nano Banana 2 işi şu anda aktif işlem görüyorsuccess - Nano Banana 2 işi başarıyla tamamlandı ve görseller üretildifailed - 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"
}| Field | Type | Description |
|---|---|---|
| image | string | Image 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
}
}| Field | Type | Description |
|---|---|---|
| result | array | Array of ImageGenResult objects (null if failed) |
| status | string | Final task status (success/failed) |
| task_id | string | Unique task identifier |
| consumed | string | Credits consumed by the task |
| status_reason | object | Status details including error message if failed |
Nano Banana 2 Desteklenen Konfigürasyonlar
google/gempix2Nano Banana image generation modelgoogle/gemini-2.5-flash-imageGemini 2.5 Flash image modelHata 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
OK
Request was successful
Bad Request
Invalid request parameters or malformed JSON
Unauthorized
Invalid, missing, or expired API key
Not Found
Task not found or endpoint doesn't exist
Internal Server Error
Server-side error occurred
Hata Çözümü Önerilen Yaklaşımlar
- Çıktı içeriğini analiz etmeden önce her zaman HTTP yanıt göstergelerini kontrol edin
- 500 hatalarında yeniden deneme mekanizmaları için aşamalı gecikme algoritmaları kullanın
- Sorun giderme için hata bildirimlerini ayrıntılı şekilde belgelendirin
- 400 hatalarını önlemek için istek göndermeden önce girdi geçerliliğini doğrulayın
- Müşterilerden API kimlik bilgisi güncellemeleri isteyerek kimlik doğrulama sorunlarını çözün
- Aşırı durum sorgulamaları yerine makul aralıklarla iş ilerlemesini takip edin
- 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;
}
}