Nano Banana API — OpenAI SDK unverändert verwenden, Preis pro Bild und Aufrufmethode

Wenn Sie nach der Nano-Banana-API auf Koreanisch suchen, teilen sich die Ergebnisse in zwei Gruppen – Googles offizielle Dokumentation oder Blogartikel wie „So erhalten Sie einen Schlüssel in AI Studio“. Was Sie tatsächlich brauchen, liegt dazwischen. Dieser Artikel beschreibt den Weg, bei dem Sie Ihr bestehendes OpenAI SDK unverändert weiterverwenden, und fasst die Preise pro Bild für die gesamte Modellfamilie in einer Tabelle zusammen. Ein Google-Cloud-Projekt ist nicht erforderlich.

Preis pro Bild – die gesamte Modellfamilie

Die folgenden Tarife sind nicht fest in diesen Artikel geschrieben, sondern werden aus dem Modellkatalog gelesen. Wenn sich die Preise ändern, ändert sich auch diese Tabelle.

Alle Preise basieren auf per image und werden vom Prepaid-Guthaben abgezogen, nicht über ein Abonnement. In Monaten ohne Generierung gibt es keine Abrechnung.

Aufrufen – nur base_url und Modellnamen ändern

Wenn Sie bereits das OpenAI SDK verwenden, müssen Sie nichts Neues lernen. Nur zwei Stellen in der Client-Initialisierung ändern sich: base_url und der Modellname.

# 기존 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)

Der Endpunkt lautet POST /v1/images/generations und entspricht dem Format von OpenAIs Bild-Endpunkt. Wenn Sie also bereits Bildgenerierung integriert haben, reicht eine einzige Änderung der Modellnamen-Zeichenfolge.

Zuerst prüfen, ob der Schlüssel funktioniert

Wenn Sie den Schlüssel und die Adresse vor Änderungen am Code mit einer einzigen Anfrage prüfen, können Sie die Ursache späterer Fehler auf den Code eingrenzen.

# 키가 되는지 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 weist auf ein Authentifizierungsproblem hin, 429 auf eine Ratenbegrenzung und 529 auf eine Überlastung des Upstreams. Zur Unterscheidung lässt sich die Entscheidungstabelle in der Zusammenfassung der Fehler von Claude Code unverändert anwenden.

Welche Stufe sollte als Standard verwendet werden?

Am effizientesten ist es, das Basismodell als Standard zu verwenden und nur bei unzureichenden Ergebnissen auf Pro zu wechseln. Da Sie dafür nur eine Zeichenfolge im Modellnamen ändern müssen, nutzen Sie den Vorteil, dass die Kosten von Vergleichsexperimenten praktisch null sind – führen Sie denselben Prompt einmal mit jeder Stufe aus und entscheiden Sie dann.

Die Videopreise finden Sie unter Preise für Veo 3, die ausführliche Dokumentation auf Englisch unter Nano Banana API. Zahlungsmethoden und die Registrierung inländischer Karten sind unter Claude API: Preise und Abrechnung zusammengefasst.

Häufig gestellte Fragen