TR ▾

Hattınız için sansürsüz metin API'si

Nano Banana API'si: Tek bir uç nokta üzerinden istemler ve komut dosyaları

Nano Banana API'siyle dakikalar içinde başlayın. Bu kılavuz; kimlik doğrulama, temel istekler, akış ve standart OpenAI uyumlu formatı kullanarak fonksiyon çağırma konularını kapsar.

Kimlik Doğrulama ve Temel URL

İstemcinizi nano banana api için https://api.nanobananaapis.com/v1 adresine yönlendirerek erişin. Geçerli bir API anahtarının Authorization başlığında olması gerekir. Anahtarınızı anında almak için yalnızca bir e-posta ve şifre ile API anahtarı al sayfasında kaydolun. Anahtar, kayıttan hemen sonra gösterilir. Kaybederseniz, kontrol panelinizden yeni bir tane oluşturabilirsiniz; eski anahtar hemen geçersiz olur.

Her istek için Bearer YOUR_API_KEY kullanın. Model kimliği her zaman uncensored'dir. Bu uç nokta metin giriş ve çıkışını işler. Resim, ses veya video üretmez. Çok modlu hatlar için bu API'yi istem yazımı, komut dosyası oluşturma ve post-prosesing için kullanın.

İlk İstek

Standart bir sohbet tamamlama isteği gönderin. API OpenAI formatını destekler. YOUR_API_KEY yerine gerçek anahtarınızı yazın. Bu örnek, sansürsüz modele basit bir mesaj gönderir.

curl https://api.nanobananaapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Yanıt oluşturulan metni içerir. Yanıt gövdesindeki kullanım token sayılarına göz atabilirsiniz. Bağlam penceresi, istem ve tamamlama için toplam 100.000 token'dır. Yüklerinizi 8 MB altında tutun.

Python SDK Örneği

Resmi OpenAI Python SDK'sını kullanın. Temel URL'yi nanobananaapis uç noktasına ayarlayın. API anahtarınızı api_key olarak iletin. İstemci, istekleri otomatik olarak doğru biçimde hazırlar. Bu yöntem, bir görüntü veya video oluşturma hizmetine göndermeden önce metin işlemeniz gereken arka uç komut dosyaları için idealdir.

from openai import OpenAI

client = OpenAI(base_url="https://api.nanobananaapis.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

SDK, sizin için akış ve ayrıştırma işlemlerini yönetir. Akış modunu etkinleştirirseniz parçalar üzerinde yineleme yapabilirsiniz. Bu yaklaşım kodunuzu temiz tutar ve daha sonra sağlayıcı değiştirirseniz diğer OpenAI hizmetleriyle uyumlu kalmasını sağlar.

Node SDK Örneği

Node.js SDK benzer şekilde çalışır. İstemciyi temel URL ve anahtarınızla başlatın. chat.completions.create yöntemini çağırın. Bu, komut dosyalarını dinamik olarak oluşturması gereken sunucusuz işlevler veya web sunucuları için kullanışlıdır.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.nanobananaapis.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Hataları düzgün şekilde işlediğinizden emin olun. Yaygın hatalar arasında anahtar geçersiz veya süresi dolmuşsa kimlik doğrulama hataları (401) ve dakikada 300 istek aşıldığında hız limitleri (429) yer alır. API anahtarı hesabınıza bağlıdır, bu nedenle ortam değişkenlerinde koruyun.

Akışlı Yanıtlar

İsteğinizde stream: true ayarlayarak akışı etkinleştirin. API, Sunucu Tarafından Gönderilen Etkinlikler (SSE) akışı döndürür. Her parça oluşturulan metnin bir bölümünü içerir. Bu, gerçek zamanlı uygulamalar veya uzun komut dosyaları oluştururken gereklidir.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

SSE olaylarını istemci tarafında ayrıştırın. Akış, model oluşturmayı bitirdiğinde veya bağlam sınırına ulaştığında sona erer. Akış, kullanıcılar için algılanan gecikmeyi azaltır. Fiyatlandırmayı değiştirmez; hala token başına ödeme yaparsınız.

Limitler, Hatalar ve Modeller

Kullanılabilir modelleri GET /v1/models ile kontrol edin. Tek model uncensored'dir. Hız limiti anahtar başına dakikada 300 istektir. İstek gövdesi 8 MB'ın altında olmalıdır. Fiyatlandırma: 1M giriş token başına $0.25 ve 1M çıktı token başına $1.00. Kredi süresi dolmaz. Bakiyeniz biterse $10'dan başlayan tutarlarla bakiye yükleyin. Hatalar: kötü anahtarlar için 401, yetersiz kredi için 402, hız limitleri için 429. SLA veya çalışma süresi garantisi verilmez. Model, küçük yaşlıları içeren cinsel içerikleri engeller. Diğer yasal yetişkin veya tartışmalı konular için reddetmez.

Sorular ve cevaplar

Bu resmi OpenAI API mi?

Hayır. Kendi açık ağırlıklı modelimizi çalıştıran OpenAI uyumlu bir API'dir. Aynı istek formatını ve SDK'ları kullanır ancak ayrı bir hizmettir. Belirli özellikler ve limitler için resmi OpenAI belgelerine bakın.

İstemlerimi eğitim için saklıyor musunuz?

Hayır. İstemlerinizi modeli eğitmek için kullanmıyoruz. Verileriniz yalnızca o isteğe yanıt oluşturmak için kullanılır. Gizlilik, sansürsüz iş akışının temel bir özelliğidir.

Bu API'yi resim oluşturma istemleri için kullanabilir miyim?

Evet. Bu API; görüntü, ses veya video modelleri için metin istemleri oluşturmak için idealdir. Hattınızın metin kısmını yönetir. Medya dosyalarını kendimiz oluşturmuyoruz.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın, temel URL'yi değiştirin. Kurulumun tamamı bu kadar.

API anahtarı al

API özellikleri

Kredi yüklemeden önce kontrol edebilmeniz için API'nin gerçek limitleri ve özellikleri tek yerde.

ÖğeDeğer
BiçimOpenAI uyumlu: herhangi bir OpenAI SDK'sı base URL ve anahtarı değiştirerek çalışır
Kimlik doğrulamaAuthorization: Bearer YOUR_KEY
Model kimliğiuncensored
Uç noktalarPOST /v1/chat/completions · GET /v1/models
Base URLhttps://api.nanobananaapis.com/v1
JSON moduresponse_format: {"type": "json_object"}
Maksimum çıktı100.000 token'lık pencerenin kalanına kadar; max_tokens isteğe bağlı (ayrı sınır yok)
Parametrelertemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Akışevet — server-sent events; son parça token kullanımını içerir
Fonksiyon çağırmaevet — tools, tool_choice; yanıtta tool_calls, akışta da; sonuçlar role: tool olarak
Bağlam penceresi100.000 token (girdi + çıktı)
İstek boyutuen fazla 8 MB
Yanıt başlıklarıX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Eşzamanlılıkanahtar başına aynı anda 8 istek
Hız limitianahtar başına dakikada 300 istek
YüklemeUSDT (TRC20) veya USDC (Base), $10–$500 arası herhangi bir tam tutar
Bonus$50'dan itibaren +%5, $100'dan itibaren +%10
Faturalamaön ödemeli kredi, gerçek kullanıma göre; hatalar ve retler ücretsiz
Ücretsiz deneme$0,50, 7 gün, kart gerekmez · Deneme anahtarı: 2 paralel istek, dakikada 60; ilk yüklemeden sonra tam limitler (8 ve 300)
Fiyat1M girdi token'ı $0,25 · 1M çıktı token'ı $1,00
Geçerliliködenen kredinin süresi dolmaz, abonelik yok
Anahtarlarhesap başına bir aktif anahtar; yenisi eskisinin yerini alır
GirişGoogle veya e-posta ve şifre
İçerikyetişkin içeriğe izin var; reşit olmayanları içeren cinsel içerik reddedilir

Hata kodları

Hatalar sabit bir type ile JSON olarak döner; başarısız veya reddedilen istekler ücretlendirilmez.

KodTürAnlamı
400bad_requestgeçersiz JSON, boş mesajlar, hatalı parametre veya bağlam çok uzun
401missing_key · invalid_key · key_revokedanahtar yok, yanlış veya değiştirilmiş
402no_creditkredi bitti — yükleyin, hemen devam eder
403content_blockedreşit olmayanları içeren cinsel içerik — reddedildi, ücret yok
404not_foundbilinmeyen uç nokta
413request_too_largegövde 8 MB'tan büyük
429rate_limited · concurrencydakikada 300 veya aynı anda 8 aşıldı — bekleyip tekrar deneyin
503upstream_busymodel meşgul — birkaç saniye sonra tekrar deneyin