Nano Banana API — OpenAI SDK ile aynı şekilde, görüntü başı fiyat ve çağrı yöntemi

Nano Banana API'sini Korece aradığınızda sonuçlar ikiye ayrılır — Google'ın resmi belgeleri veya “AI Studio'dan anahtar alma” blog yazısı. Asıl gereken ikisinin arasındadır. Bu yazı, mevcut OpenAI SDK'sını değiştirmeden çağrı yapma yolunu ve tüm serinin görüntü başına fiyatlarını tek tabloda düzenler. Google Cloud projesi gerekmez.

Görüntü başına fiyat — tüm seri

Aşağıdaki ücretler yazıya elle eklenmez; model kataloğundan okunur. Fiyat değiştiğinde bu tablo da otomatik olarak güncellenir.

Tümü per image temel alınarak ücretlendirilir ve abonelikten değil, ön ödemeli bakiyeden düşülür. Üretim yapılmayan aylarda ücret alınmaz.

Çağrı — yalnızca base_url ve model adını değiştirin

Zaten OpenAI SDK kullanıyorsanız yeni bir şey öğrenmeniz gerekmez. İstemci başlatma kodunda yalnızca base_url ve model adı olmak üzere iki yer değişir.

# 기존 OpenAI SDK를 그대로 씁니다. base_url과 모델 이름만 바뀝니다.
# Google Cloud 프로젝트도, 별도 SDK 설치도 필요 없습니다.
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.kunavo.com/v1",
    api_key=os.environ["KUNAVO_API_KEY"],
)

img = client.images.generate(
    model="nano-banana-2",
    prompt="한옥 마당에 눈이 내리는 장면, 따뜻한 조명, 사진 스타일",
    n=1,
)
print(img.data[0].url)

Uç nokta POST /v1/images/generations şeklindedir ve OpenAI'nin görüntü uç noktasıyla aynı formattadır. Bu nedenle görüntü üretimi zaten eklenmiş bir kodunuz varsa model adı dizesini değiştirerek geçiş yapabilirsiniz.

Önce anahtarın çalıştığını doğrulayın

Kodu değiştirmeden önce tek bir istekle anahtarı ve adresi doğrularsanız, daha sonra hata oluştuğunda nedeni kod tarafına daraltabilirsiniz.

# 키가 되는지 30초 만에 확인하는 최소 요청
curl -sS https://api.kunavo.com/v1/images/generations \
  -H "Authorization: Bearer sk-kn-..." \
  -H "content-type: application/json" \
  -d '{"model":"nano-banana","prompt":"a paper crane on a desk","n":1}'

401 kimlik doğrulama, 429 hız sınırı, 529 ise üst akış aşırı yükü anlamına gelir. Bunları ayırt etmek için Claude Code hata özeti içindeki karar tablosu aynen uygulanır.

Hangi seviyeyi varsayılan yapmalısınız?

Temel modeli varsayılan olarak kullanıp yalnızca sonuç yetersiz kaldığında Pro'ya geçmek, maliyet açısından en verimli yöntemdir. Yalnızca model adı dizesini değiştirmeniz gerektiğinden karşılaştırma deneylerinin maliyetinin fiilen yok olması avantajını kullanın — aynı istemi iki seviyede birer kez çalıştırıp karar verebilirsiniz.

Video tarafındaki fiyatlar Veo 3 fiyatları sayfasında, İngilizce ayrıntılı belge Nano Banana API sayfasındadır. Ödeme yöntemleri ve Kore kartı kaydı Claude API fiyatlandırma ve ödemeleri sayfasında açıklanır.

Sık sorulan sorular