Nano Banana 2 API-Referenz
Schnelle Gemini-Bilder bis 4K, mit bis zu 14 Referenzen
Mit einem einzigen PopNow-API-Schlüssel rufst du Nano Banana 2 aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.
Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.
Auf einen Blick
- Hersteller
- Ergebnis
- Bild
- Ab
- 5.4 Credits pro Bild ($0.054)
- Typische Dauer
- etwa 55 s
1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.
Bild erstellen
google/nano-banana-2/text-to-image
Preis
| Option | Credits (pro Bild) | US-Dollar |
|---|---|---|
0.5k | 5.4 | $0.054 |
1k | 8.04 | $0.0804 |
2k | 12.12 | $0.1212 |
4k | 18.12 | $0.1812 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
promptPflicht | string | — | bis zu 5.000 Zeichen | Describe the image you want. |
aspect_ratioOptional | string | 16:9 | 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, 8:1 | Output aspect ratio. |
resolutionOptional | string | 1k | 0.5k, 1k, 2k, 4k | Output size tier. |
enable_web_searchOptional | boolean | false | — | Look up current facts on the web before drawing. |
enable_image_searchOptional | boolean | false | — | Look up reference pictures on the web before drawing. |
Beispielanfrage
Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/nano-banana-2/text-to-image",
"input": {
"prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
"enable_image_search": false,
"enable_web_search": false,
"resolution": "1k"
}
}'Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"Bild bearbeiten
google/nano-banana-2/edit
Preis
| Option | Credits (pro Bild) | US-Dollar |
|---|---|---|
0.5k | 5.4 | $0.054 |
1k | 8.04 | $0.0804 |
2k | 12.12 | $0.1212 |
4k | 18.12 | $0.1812 |
Parameter
| Feld | Typ | Standardwert | Erlaubt | Bedeutung |
|---|---|---|---|---|
promptPflicht | string | — | bis zu 5.000 Zeichen | Say what to change and what must stay the same. |
image_urlsPflicht | array<string (uri)> | — | bis zu 14 Einträge | One to 14 source images, in the order your prompt refers to them. |
aspect_ratioOptional | string | auto | auto, 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 4:1, 1:8, … (+1) | Output aspect ratio; auto keeps the shape of the source image. |
resolutionOptional | string | 1k | 0.5k, 1k, 2k, 4k | Output size tier. |
enable_web_searchOptional | boolean | false | — | Look up current facts on the web before drawing. |
enable_image_searchOptional | boolean | false | — | Look up reference pictures on the web before drawing. |
Beispielanfrage
Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.
Das Beispiel nutzt in image_urls Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/nano-banana-2/edit",
"input": {
"prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"enable_image_search": false,
"enable_web_search": false,
"resolution": "1k"
}
}'Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"