Einführung
Nano Banana Pro Bildbearbeitung wendet das Gemini 3 Pro Image von Google auf vorhandene Bilder an. Es nimmt ein bis vierzehn Quellen an, plant die Bearbeitung vor dem Rendern und liefert 1k, 2k oder 4k im Format der Quelle oder in einem von zehn Formaten.
Modus nach dem Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| ein schriftliches Briefing | Nano Banana Pro Text-zu-Bild |
| ein Bild, das geändert werden soll | Nano Banana Pro Bildbearbeitung |
Wichtige Funktionen und Highlights
Sorgfältige Bearbeitungen mit einer Änderung
Neues Licht, ein neuer Hintergrund oder hinzugefügter Text, während die Personen und der Rest des Bildes bleiben, wie sie waren, wie in unseren Beispielen mit Kerzenlicht und Cover. Das Modell plant die Bearbeitung vor dem Rendern, was nicht betroffene Bildteile stabil hält.
Text über Fotos
Titel, Ausgabenzeilen und Bildunterschriften werden in der zitierten Schreibweise auf das Bild gesetzt, an der Stelle, die Sie angeben.
Bis zu vierzehn Referenzen
Personen, Produkte und Umgebungen aus vielen Quellen kombinieren, jede über ihre Rolle im Prompt beschrieben, in einer einzigen Bearbeitungsanfrage.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
prompt | Ja | Bis zu 5.000 Zeichen. Beschreiben Sie Motiv, Umgebung, Licht und Objektiv in ganzen Sätzen; Wörter in Anführungszeichen erscheinen als Text im Bild. mindestens 1 Zeichen · höchstens 5000 Zeichen |
image_urls | Ja | 1 bis 14 Quellbilder. Sagen Sie im Prompt, was jedes beiträgt: die Person, die Umgebung, das Produkt. mindestens 1 Einträge · höchstens 14 Einträge |
aspect_ratio | Nein | auto (Standard) übernimmt das Format des Quellbilds; alternativ eines von zehn Formaten von 21:9 bis 9:16. Das Format ändert den Preis nicht. |
resolution | Nein | 1k (Standard), 2k oder 4k. 1k und 2k kosten gleich viel; 4k kostet mehr und rendert 4096 Pixel an der langen Seite. |
official_fallback | Nein | Standardmäßig eingeschaltet. Jede Bearbeitung läuft zuerst auf der Economy-Route. Standardwert: |
Preis
Abrechnung pro Bild nach Größenstufe. Jede Bearbeitung startet auf der Economy-Route zum Economy-Preis, ohne Gebühr pro Quellbild. Ist Official fallback eingeschaltet (Standard), läuft eine Bearbeitung, die die Economy-Route ablehnt oder nicht abschließen kann, oder eine mit mehr als 8 Quellbildern über die offizielle Route zum offiziellen Preis, der zusätzlich eine kleine Pauschale für jedes Quellbild enthält; ausgeschaltet zahlen Sie nur den Economy-Preis. Das Angebot zeigt den Einstiegspreis und den Höchstbetrag der Bearbeitung. Abgelehnte Anfragen werden nicht berechnet.
| Spezifikation | Preis |
|---|---|
| $0.0668 / Bild (Mit Official fallback: bis zu $0.1072) |
| $0.0668 / Bild (Mit Official fallback: bis zu $0.1072) |
| $0.118 / Bild (Mit Official fallback: bis zu $0.192) |
Anwendungsfälle
Fotos zu Covern und Plakaten machen
Einem freigegebenen Foto einen Titel, ein Datum und eine Textzeile hinzufügen, ohne es zu retuschieren.
Stimmungs- und Lichtvarianten
Dieselbe Szene bei Kerzenlicht, im Morgengrauen oder unter Neon zeigen, für einen Kunden, der eine Richtung wählt.
Lokalisierte Kampagnenbilder
Den Text auf einem fertigen Plakat für jeden Markt durch eine übersetzte Zeile ersetzen, während das Foto und sein Licht unberührt bleiben.
Prompt-Leitfaden und Praxistipps
Eine Sache nach der anderen ändern
Anweisungen mit einer einzigen Änderung halten alles andere stabil; verketten Sie mehrere Bearbeitungen, statt sie in einen Prompt zu packen.
Die Personen schützen
Nennen Sie nach der Änderung die Person, das Outfit und die Pose, die genau gleich bleiben müssen.
Zeit für Bearbeitungen einplanen
Bearbeitungen laufen bei diesem Modell länger als Text-zu-Bild: auf der offiziellen Route in unseren Tests in 2k bis zu etwa drei Minuten, während unsere Bearbeitungen in 1k auf der Economy-Route in unter einer Minute fertig waren.
Text mit seiner Position zitieren
Zitieren Sie für hinzugefügten Text jede Zeile und sagen Sie, wo sie steht: oben quer, unten links, neben dem Logo.
2k als Standard verwenden
1k und 2k kosten bei diesem Modell gleich viel, bearbeiten Sie also in 2k, außer Sie brauchen eine kleinere Datei.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/nano-banana-pro/edit",
"input": {
"aspect_ratio": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
