So verwenden Sie die Nano Banana 2 API: Vollständiges Tutorial mit Codebeispielen (2026)

Kurzübersicht

• Nano Banana 2 (gemini-3.1-flash-image-preview) wurde am 26. Feb. 2026 veröffentlicht — Pro-Level-Qualität bei Flash-Geschwindigkeit
• Erfordert einen kostenpflichtigen API-Schlüssel. Das kostenlose Kontingent für Bildgenerierung ist null
• Google-Preise: $0.101/Bild (2K), $0.150/Bild (4K). EvoLink bietet ~20 % günstiger ab $0.0806 (2K)
• Drei Zugriffsmöglichkeiten: Google AI Studio (ohne Code), Gemini API (Python/Node.js) oder über ein einheitliches Gateway
• Dieses Tutorial bringt Sie in unter 10 Minuten zur Bildgenerierung

Was ist Nano Banana 2?

Nano Banana 2 ist Googles neuestes Bildgenerierungsmodell, basierend auf Gemini 3.1 Flash Image. Am 26. Februar 2026 ersetzte Nano Banana 2 Nano Banana Pro als Standard-Bildmodell in den Modi Fast, Thinking und Pro der Gemini-App.

• Modell-ID: gemini-3.1-flash-image-preview
• Auflösung: 512px bis 4K, native Seitenverhältnisse einschließlich 4:1, 1:4, 8:1, 1:8
• Motivkonsistenz: Bis zu 5 Charaktere + 14 Objekte pro Generierung
• Textdarstellung: Verbesserte mehrsprachige In-Bild-Texte
• Thinking-Stufen: Minimal (Standard) vs. Hoch/Dynamisch für komplexe Prompts
• KI-Identifikation: SynthID + C2PA Content Credentials

Voraussetzungen: Was Sie vor dem Start benötigen

Hier bleiben die meisten Entwickler hängen. Auf Reddit ist die häufigste Beschwerde das Auftreten von Kontingent-Fehlern, ohne zu verstehen, warum.

Wenn Sie es mit einem kostenlosen Schlüssel versuchen, erhalten Sie:

Option A: Google Cloud-Abrechnung

1. Gehen Sie zu Google AI Studio
2. Klicken Sie auf Get API Key → Create API key
3. Verknüpfen Sie ein Rechnungskonto unter Google Cloud Console → Billing
4. Aktivieren Sie die Gemini API in Ihrem Projekt
5. Ihr Schlüssel funktioniert jetzt für die Bildgenerierung

Option B: Drittanbieter-Gateway

Methode 1: Google AI Studio (ohne Code)

Der schnellste Weg zum Testen ohne Code:

1. Öffnen Sie AI Studio
2. Wählen Sie gemini-3.1-flash-image-preview aus dem Modell-Dropdown
3. Geben Sie einen Prompt ein: „Ein fotorealistischer Golden-Retriever-Welpe auf einer sonnigen Wiese"
4. Klicken Sie auf Run

Wenn Sie „only available for paid tier users" sehen, ist Ihre Abrechnung noch nicht verknüpft (siehe Voraussetzungen oben).

Ideal zum Testen von Prompts, bevor Sie Integrationscode schreiben.

Methode 2: Gemini API direkt

Python

pip install google-generativeai

import google.generativeai as genai
import base64

genai.configure(api_key="YOUR_PAID_API_KEY")

model = genai.GenerativeModel("gemini-3.1-flash-image-preview")

response = model.generate_content(
    "A photorealistic golden retriever puppy sitting in a sunlit meadow, "
    "soft bokeh background, warm afternoon light",
    generation_config=genai.GenerationConfig(
        response_modalities=["image", "text"],  # Optional; model defaults to both text and image
    ),
)

for part in response.parts:
    if part.inline_data:
        image_data = base64.b64decode(part.inline_data.data)
        with open("output.png", "wb") as f:
            f.write(image_data)
        print("Image saved to output.png")
    elif part.text:
        print(f"Response: {part.text}")

Node.js

npm install @google/generative-ai

const { GoogleGenerativeAI } = require("@google/generative-ai");
const fs = require("fs");

const genAI = new GoogleGenerativeAI("YOUR_PAID_API_KEY");

async function generateImage() {
  const model = genAI.getGenerativeModel({
    model: "gemini-3.1-flash-image-preview",
  });

  const result = await model.generateContent({
    contents: [
      {
        role: "user",
        parts: [
          {
            text: "A photorealistic golden retriever puppy sitting in a sunlit meadow, soft bokeh background, warm afternoon light",
          },
        ],
      },
    ],
    generationConfig: {
      responseModalities: ["image", "text"],
    },
  });

  const response = result.response;
  for (const part of response.candidates[0].content.parts) {
    if (part.inlineData) {
      const buffer = Buffer.from(part.inlineData.data, "base64");
      fs.writeFileSync("output.png", buffer);
      console.log("Image saved to output.png");
    } else if (part.text) {
      console.log("Response:", part.text);
    }
  }
}

generateImage();

Methode 3: OpenAI-kompatibles Gateway (EvoLink)

Wenn Sie bereits das OpenAI SDK verwenden, können Sie Bilder generieren, ohne Ihre Codestruktur zu ändern — zeigen Sie einfach auf eine andere Base-URL.

Python (OpenAI SDK)

pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_EVOLINK_API_KEY",
    base_url="https://api.evolink.ai/v1",
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[
        {
            "role": "user",
            "content": "A photorealistic golden retriever puppy sitting in a sunlit meadow",
        }
    ],
)

print(response.choices[0].message.content)

Node.js (OpenAI SDK)

npm install openai

const OpenAI = require("openai");

const client = new OpenAI({
  apiKey: "YOUR_EVOLINK_API_KEY",
  baseURL: "https://api.evolink.ai/v1",
});

async function generateImage() {
  const response = await client.chat.completions.create({
    model: "gemini-3.1-flash-image-preview",
    messages: [
      {
        role: "user",
        content:
          "A photorealistic golden retriever puppy sitting in a sunlit meadow",
      },
    ],
  });

  console.log(response.choices[0].message.content);
}

generateImage();

Warum ein Gateway verwenden? Ein API-Schlüssel für mehrere Modelle (NB2, Pro, GPT-4o Image, Seedream). Keine Google Cloud-Abrechnungseinrichtung. Gleiches Modell, gleiche Ausgabe.

Preisübersicht

Die Kosten für Text-Token sind vernachlässigbar (~$0.0001 pro Prompt). Die Kosten entstehen beim Bild-Output-Token.

Bei Batch-Workloads (100+ Bilder/Tag) summieren sich die Einsparungen schnell.

Tipps für Prompt Engineering

Seien Sie spezifisch

Verwenden Sie Stil-Schlüsselwörter

Nutzen Sie Thinking-Stufen

Für komplexe Prompts mit mehreren Motiven aktivieren Sie höheres Thinking:

generation_config=genai.GenerationConfig(
    response_modalities=["image", "text"],
    thinking_config={"thinking_budget": 1024},  # Higher = more reasoning
)

Multi-Turn-Bearbeitung

Generieren Sie ein Bild und verfeinern Sie es in Folgenachrichten:

Fehlerbehebung

Kontingent-Fehler (Quota Exceeded)

400 Bad Request

Häufige Ursachen:

• Tippfehler in der Modell-ID
• Nicht unterstütztes Seitenverhältnis

Textantwort statt Bild

generation_config=genai.GenerationConfig(
    response_modalities=["image", "text"],
)

FAQ

A: Nein. Bildgenerierung erfordert einen kostenpflichtigen API-Schlüssel mit aktivierter Abrechnung. Das kostenlose Kontingent ist 0.

A: 2K: $0.101 bei Google direkt. 4K: $0.150. Plus vernachlässigbare Text-Token-Kosten (~$0.0001/Prompt). Preise Stand Februar 2026.

A: Googles RPM-Limits variieren je nach Abrechnungsstufe und sind nicht vollständig dokumentiert. Implementieren Sie exponentielles Backoff für 429-Fehler.

A: Ja. Über Multi-Turn-Konversationen — generieren Sie ein Bild und beschreiben Sie Änderungen in Folgenachrichten.

A: 512px, 1K, 2K, 4K. Seitenverhältnisse: 1:1, 16:9, 9:16, 4:3, 3:4, 4:1, 1:4, 8:1, 1:8.

A: SynthID (unsichtbar) + C2PA Content Credentials. Visuell nicht sichtbar, aber durch Verifizierungstools erkennbar.

Jetzt loslegen

Drei Schritte:

1. Holen Sie sich einen kostenpflichtigen API-Schlüssel (Google AI Studio oder evolink.ai/signup)
2. Kopieren Sie den obigen Code
3. Führen Sie ihn aus