Nano Banana Pro API Vollständiger Leitfaden für die Ausgabe im Original-Seitenverhältnis: Bildgenerierung in Originalgröße in 3 Szenarien

Anmerkung des Autors: Detaillierte Erklärung, wie die Nano Banana Pro API eine Ausgabe im Originalverhältnis erreicht, Beherrschung des Tricks zum Weglassen des Parameters aspect_ratio und Lösung von Problemen bei der Größenbeibehaltung in Bildbearbeitungsszenarien.

Bei der Bildbearbeitung mit der Nano Banana Pro API ist die Beibehaltung der Originalmaße des Bildes ein häufiges Problem für Entwickler. Die offizielle Dokumentation beschränkt aspect_ratio ausdrücklich auf 10 feste Verhältnisse, aber tatsächlich gibt es eine einfache Lösung: Im Szenario der Bildbearbeitung lassen Sie den Parameter aspect_ratio einfach weg, um eine Ausgabe in Originalgröße zu erhalten.

Kernwert: Nach der Lektüre dieses Artikels werden Sie die vollständigen Techniken für die Ausgabe im Originalverhältnis der Nano Banana Pro API beherrschen und die Bildgrößen in verschiedenen Szenarien flexibel steuern können.

Kernpunkte der Nano Banana Pro Ausgabe im Originalverhältnis

Das Schlüsselprinzip der Nano Banana Pro Ausgabe im Originalverhältnis

Nano Banana Pro (alias Gemini 3 Pro Image) weist bei der Bildverarbeitung zwei unterschiedliche Standardverhaltensweisen auf. Bei reinen Text-zu-Bild-Szenarien (text-to-image) gibt die API standardmäßig ein quadratisches Bild im Verhältnis 1:1 aus, wenn kein aspect_ratio angegeben wird.

Im Bildbearbeitungs-Szenario (image-to-image) verhält sich die API jedoch völlig anders. Wenn Sie ein Referenzbild bereitstellen und eine Bearbeitung anfordern, erkennt die API automatisch die Originalmaße des Eingabebildes und gibt das bearbeitete Ergebnis in derselben Größe aus, sofern Sie den Parameter aspect_ratio weglassen. Dies ist der Kernmechanismus für die Ausgabe im Originalverhältnis.

Warum die Nano Banana Pro Ausgabe im Originalverhältnis effektiv ist

Dieses Design ist absolut sinnvoll: Wenn ein Benutzer ein Bild zur Bearbeitung hochlädt, erwartet er normalerweise, dass das ausgegebene Bild dieselben Abmessungen und Proportionen wie das Original hat. Den Benutzer zu zwingen, Verhältnisse manuell zu berechnen und anzugeben, erhöht nicht nur die Komplexität der Entwicklung, sondern kann auch zu Bildverformungen oder unerwünschtem Zuschnitt führen, wenn das Verhältnis nicht exakt übereinstimmt.

Detaillierte Erläuterung der offiziellen Regeln für die Nano Banana Pro Ausgabe im Originalverhältnis

Die offizielle API-Dokumentation legt fest, dass der Parameter aspect_ratio nur die folgenden 10 vordefinierten Werte akzeptiert:

Wichtiger Hinweis: Die oben genannten Verhältnisbeschränkungen gelten nur für Szenarien, in denen eine bestimmte Größe explizit festgelegt werden muss. Bei der Bildbearbeitung empfiehlt es sich, Tests über die Plattform APIYI (apiyi.com) durchzuführen. Wenn Sie den Parameter aspect_ratio einfach weglassen, wird die Ausgabe automatisch in der Originalgröße erzeugt.

Schnelleinstieg in die Nano Banana Pro Ausgabe im Originalverhältnis

Minimalistisches Beispiel: Bildbearbeitung unter Beibehaltung der Originalgröße

Hier ist der einfachste Weg, eine Ausgabe im Originalverhältnis zu realisieren:

import openai
import base64

client = openai.OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://vip.apiyi.com/v1"
)

# Originalbild einlesen und kodieren
with open("input.jpg", "rb") as f:
    image_base64 = base64.b64encode(f.read()).decode()

# Entscheidend: Den Parameter aspect_ratio nicht übergeben
response = client.chat.completions.create(
    model="gemini-3-pro-image-preview",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{image_base64}"}},
            {"type": "text", "text": "Ändere den Hintergrund des Bildes in eine Sonnenuntergangsszene"}
        ]
    }]
)

import openai
import base64
from pathlib import Path

def edit_image_keep_ratio(
    image_path: str,
    edit_prompt: str,
    output_path: str = "output.png"
) -> bool:
    """
    Bild bearbeiten und Originalgröße beibehalten

    Args:
        image_path: Pfad zum Eingabebild
        edit_prompt: Bearbeitungsanweisung
        output_path: Pfad zum Ausgabebild

    Returns:
        Erfolgsstatus
    """
    client = openai.OpenAI(
        api_key="YOUR_API_KEY",
        base_url="https://vip.apiyi.com/v1"
    )

    # Bild einlesen und kodieren
    image_data = Path(image_path).read_bytes()
    image_base64 = base64.b64encode(image_data).decode()

    # Bildformat erkennen
    suffix = Path(image_path).suffix.lower()
    mime_type = {"jpg": "jpeg", "jpeg": "jpeg", "png": "png", "webp": "webp"}.get(suffix[1:], "jpeg")

    try:
        # Kernpunkt: aspect_ratio weglassen, um die Originalgröße automatisch beizubehalten
        response = client.chat.completions.create(
            model="gemini-3-pro-image-preview",
            messages=[{
                "role": "user",
                "content": [
                    {"type": "image_url", "image_url": {"url": f"data:image/{mime_type};base64,{image_base64}"}},
                    {"type": "text", "text": edit_prompt}
                ]
            }]
        )

        # Ergebnis speichern
        result_base64 = response.choices[0].message.content
        output_data = base64.b64decode(result_base64)
        Path(output_path).write_bytes(output_data)
        return True

    except Exception as e:
        print(f"Bearbeitung fehlgeschlagen: {e}")
        return False

# Anwendungsbeispiel
edit_image_keep_ratio(
    "product.jpg",
    "Entferne den Bildhintergrund und behalte nur das Hauptprodukt bei",
    "product_nobg.png"
)

Empfehlung: Holen Sie sich kostenlose Test-Credits über APIYI (apiyi.com), um den Effekt der Ausgabe im Originalverhältnis schnell zu validieren. Die Plattform unterstützt den vollen Funktionsumfang des Nano Banana Pro Modells.

Nano Banana Pro: Vergleich der Ausgabe im Originalseitenverhältnis in drei Szenarien

Szenario 1: Text-zu-Bild erfordert ein festgelegtes Verhältnis

Bei der reinen Text-zu-Bild-Generierung muss der Parameter aspect_ratio explizit übergeben werden, wenn eine bestimmte Größe gewünscht ist:

response = client.chat.completions.create(
    model="gemini-3-pro-image-preview",
    messages=[{"role": "user", "content": "Eine süße Katze"}],
    extra_body={
        "image_config": {
            "aspect_ratio": "16:9",  # Zwingend erforderlich
            "resolution": "2K"
        }
    }
)

Szenario 2: Bildbearbeitung unter Beibehaltung der Originalgröße

Dies ist das Kernszenario dieses Artikels: Lassen Sie aspect_ratio einfach weg, um die Dimensionen beizubehalten:

response = client.chat.completions.create(
    model="gemini-3-pro-image-preview",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{img}"}},
            {"type": "text", "text": "Farben des Bildes verstärken"}
        ]
    }]
    # extra_body oder aspect_ratio werden nicht übergeben
)

Szenario 3: Bildbearbeitung mit erzwungener Änderung des Verhältnisses

Falls Sie die Größe während der Bearbeitung tatsächlich ändern möchten, können Sie den Parameter explizit übergeben:

response = client.chat.completions.create(
    model="gemini-3-pro-image-preview",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{img}"}},
            {"type": "text", "text": "Bild in eine quadratische Komposition ändern"}
        ]
    }],
    extra_body={"image_config": {"aspect_ratio": "1:1"}}
)

Vergleichshinweis: Die obigen Parameterkonfigurationen wurden auf der Plattform APIYI (apiyi.com) verifiziert und sind praxiserprobt.

Häufig gestellte Fragen (FAQ)

Fazit

Die Kernpunkte für die Ausgabe in Originalgröße bei Nano Banana Pro sind:

1. Weglassen bedeutet Originalgröße: In Bildbearbeitungsszenarien wird die Originalgröße beibehalten, wenn der Parameter aspect_ratio nicht übergeben wird.
2. Unterschiedliche Szenarien verstehen: Text-zu-Bild ist standardmäßig 1:1, während die Bildbearbeitung standardmäßig die Originalgröße nutzt – die beiden Modi verhalten sich unterschiedlich.
3. 10 vordefinierte Verhältnisse: Wenn du eine Größe festlegen musst, kannst du nur aus den 10 offiziell unterstützten Seitenverhältnissen wählen.

Mit diesem Wissen kannst du in Szenarien wie Produktbildbearbeitung, Porträt-Retusche oder Hintergrundersetzung ganz einfach Ausgaben in Originalgröße erzielen und dir den Aufwand einer nachträglichen Größenanpassung sparen.

Wir empfehlen, die Ergebnisse schnell über APIYI (apiyi.com) zu validieren. Die Plattform bietet kostenloses Guthaben und volle Unterstützung für das Nano Banana Pro Modell.

📚 Referenzmaterialien

⚠️ Hinweis zum Linkformat: Alle externen Links verwenden das Format Materialname: domain.com. Dies ermöglicht ein einfaches Kopieren, verhindert jedoch die direkte Verlinkung, um den Verlust von SEO-Autorität (Link Juice) zu vermeiden.

1. Google Gemini API Offizielle Dokumentation: Vollständige Parameterbeschreibung für die Bilderzeugung mit Nano Banana

   • Link: ai.google.dev/gemini-api/docs/nanobanana
   • Beschreibung: Offizielle, maßgebliche Dokumentation, einschließlich der vollständigen Definition des Parameters aspect_ratio.

2. fal.ai Nano Banana Pro API: Detaillierte Schnittstellenbeschreibung der Drittanbieter-Plattform

   • Link: fal.ai/models/fal-ai/nano-banana-pro/edit/api
   • Beschreibung: Enthält Beispiele für die Parameterkonfiguration in Image-to-Image-Szenarien.

3. Google AI Entwicklerforum: Community-Diskussionen und Q&A

   • Link: discuss.ai.google.dev
   • Beschreibung: Hier finden Sie Erfahrungsberichte anderer Entwickler zur Steuerung der Bildgrößen.

Autor: Technik-Team
Technischer Austausch: Diskutieren Sie gerne Tipps zur Nutzung der Nano Banana Pro API im Kommentarbereich. Weitere Informationen finden Sie in der APIYI apiyi.com Technik-Community.