Nano Banana 2.1 API: model-ID, prijzen, resoluties en limieten
Door Potto AI Team·
Dit zijn de Nano Banana 2.1 API-feiten: model-ID gemini-nano-banana-2.1, aanvraagvelden, 1K/2K/4K-formaten, 14 referenties, prijzen en limieten.
De Nano Banana 2.1 API is het Gemini API-model gemini-nano-banana-2.1 van Google, een zeer efficiënt model voor beeldgeneratie en conversationeel bewerken dat je aanroept met een tekstprompt en optioneel referentieafbeeldingen. Volgens de Nano Banana 2.1-modelpagina van Google retourneert het afbeeldingen van 1K (de standaard), 2K of 4K, accepteert het tot 14 referentieafbeeldingen (tot 10 objecten en tot 4 personages) en heeft het een configureerbare denkmodus. De standaardprijs van Google is $0.0336 per 1K-afbeelding, $0.0504 per 2K-afbeelding en $0.113 per 4K-afbeelding, en batchtaken worden tegen de helft daarvan geprijsd.
Deze gids bundelt de integratiefeiten op één plek: het model-ID, welk endpoint je moet aanroepen, de relevante aanvraagvelden, uitvoerformaten, referentieafbeeldingsslots, prijzen, snelheidslimieten en batchtaken. Elk nummer is afkomstig uit de officiële documentatie van Google, gelezen op 2026-10-10. Prijzen en limieten veranderen, dus controleer ze op de pagina's van Google voordat je een budget opstelt of lanceert.
Potto biedt geen openbare API aan. Om het model vanuit je eigen code aan te roepen, gebruik je rechtstreeks de Gemini API van Google. Als je alleen de afbeeldingen wilt, kun je op de Nano Banana 2.1-pagina in de webgenerator van Potto met hetzelfde model maken en bewerken zonder een aanvraag te schrijven.
Nano Banana 2.1 API in één oogopslag
Item
Wat de documentatie van Google zegt
Model-ID
gemini-nano-banana-2.1 (de stabiele versie gebruikt hetzelfde ID)
Invoer
Tekst, afbeelding, video en PDF
Uitvoer
Afbeelding en tekst
Uitvoerresoluties
1K (standaard), 2K, 4K; 512px wordt niet ondersteund op 2.1
Referentieafbeeldingen
Maximaal 14 in totaal: tot 10 objecten en tot 4 personages
Denkmodus-niveaus
minimal, medium (standaard), high
Grounding
Google Web en Image Search
Batch API
Ondersteund
Niet ondersteund
Function calling, structured outputs, caching, code execution, URL-context, Maps-grounding, Live API, audiogeneratie
Gratis laag
Niet beschikbaar
Standaardprijs per afbeelding
$0.0336 (1K), $0.0504 (2K), $0.113 (4K)
Batchprijs per afbeelding
$0.0168 (1K), $0.0252 (2K), $0.0567 (4K)
Bronnen: de modelpagina van Google (laatst bijgewerkt op 2026-10-06 UTC) en de prijzenpagina, geraadpleegd op 2026-10-10.
Wat is de Nano Banana 2.1 API?
"Nano Banana" is de populaire naam voor de beeldgeneratie- en beeldbewerkingsmodellen van Google in de Gemini-familie, en de "Nano Banana 2.1 API" is simpelweg de manier om er daar één van vanuit code te bereiken. Er is geen apart product om je voor aan te melden: je gebruikt een Gemini API-sleutel en noemt het model-ID in de aanvraag. De beeldgeneratiegids van Google noemt vijf modellen onder de naam Nano Banana, elk met een eigen ID:
Naam
Model-ID
Nano Banana 2.1
gemini-nano-banana-2.1
Nano Banana 2 Lite
gemini-3.1-flash-lite-image
Nano Banana 2
gemini-3.1-flash-image
Nano Banana Pro
gemini-3-pro-image
Nano Banana (origineel)
gemini-2.5-flash-image
De gids van Google noemt 2.1 het primaire, zeer efficiënte werkpaardmodel voor beeldgeneratie en conversationeel bewerken en beveelt het aan voor alle nieuwe projecten. Voor een vergelijking met het Pro-model lees je de gids Nano Banana 2.1 vs Nano Banana Pro; dit artikel blijft bij de integratie van 2.1.
Google noemt betere visuele kwaliteit en realisme bij 1K, 2K en 4K, verholpen tiling-artefacten bij brede en panoramische beeldverhoudingen (1:4, 4:1, 1:8 en 8:1) op 2K en 4K, verbeterde tekstweergave en nauwkeurigheid van infographic-lay-outs, en grounding met Google Web en Image Search. De documentatie publiceert geen benchmarkscores, dus test je eigen prompts voordat je een pipeline aan het model toevertrouwt.
Welk endpoint moet je aanroepen?
Roep de Interactions API aan. Google's gids voor beeldgeneratie gebruikt die voor elk Nano Banana 2.1-voorbeeld: een POST naar https://generativelanguage.googleapis.com/v1beta/interactions met je sleutel in een x-goog-api-key-header. In het overzicht van Google's Interactions API staat dat deze sinds juni 2026 algemeen beschikbaar is en aanbevolen wordt voor alle nieuwe projecten, en dat alle nieuwe modellen, tools en agentische functies daar worden gelanceerd. De oudere generateContent API wordt beschreven als legacy, maar blijft volledig ondersteund.
De SDK-aanroepen (client.interactions.create) vereisen google-genai of @google/genai versie 2.3.0 of later. Het overzicht noemt ook de Batch API, expliciete caching en aangepaste veiligheidsinstellingen als nog niet beschikbaar op Interactions, dus batch-prijzen betekenen dat je generateContent gebruikt, zoals de batch-sectie uitlegt.
Verstuur je eerste Nano Banana 2.1 API-aanvraag
De kleinste aanvraag noemt het model en geeft de prompt door als een tekstitem. De gids van Google toont deze REST-aanroep:
curl -s -X POST \
"https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-nano-banana-2.1",
"input": [
{"type": "text", "text": "Create a picture of a nano banana dish in a fancy restaurant with a Gemini theme"}
]
}'
Om de vorm van het resultaat te kiezen, voeg je een response_format-object toe. Dezelfde velden verschijnen in het Python-voorbeeld van Google, waar de uitvoer wordt gelezen uit interaction.output_image:
-d '{
"model": "gemini-nano-banana-2.1",
"input": [{"type": "text", "text": "A cedar bottle on a linen cloth, soft window light"}],
"response_format": {
"type": "image",
"mime_type": "image/jpeg",
"aspect_ratio": "16:9",
"image_size": "2K"
},
"generation_config": {"thinking_level": "medium"}
}'
De velden in gewone taal:
Veld
Wat het doet
input
De prompt als {"type": "text", "text": ...}-items, plus {"type": "image", ...}-items voor referentieafbeeldingen
response_format.mime_type
image/jpeg of image/png in de voorbeelden van Google
response_format.aspect_ratio
Bijvoorbeeld 1:1, 5:4 of 16:9 in de voorbeelden van Google
response_format.image_size
1K, 2K of 4K, met een hoofdletter K
generation_config.thinking_level
minimal, medium of high
previous_interaction_id
Vervolgt een eerdere interactie voor multi-turn bewerken
In de SDK-voorbeelden komt de afbeelding base64-gecodeerd binnen in interaction.output_image.data, en het Python-voorbeeld decodeert deze met base64.b64decode voordat het bestand wordt geschreven. De interactie bevat ook steps, die denkstappen en de uiteindelijke model_output kunnen bevatten. Het REST-voorbeeld van Google print geen response body, dus inspecteer een echte response voordat je een parser voor de raw JSON schrijft.
Uitvoerformaten van de Nano Banana 2.1 API: 1K, 2K en 4K
Nano Banana 2.1 levert drie uitvoerformaten: 1K, 2K en 4K, waarbij 1K de standaard is wanneer je image_size niet instelt. De prijzenpagina van Google vermeldt de image-tokens die elk formaat verbruikt: 1,120 voor een 1K-afbeelding, 1,680 voor 2K en 3,780 voor 4K.
Regels uit de handleiding voor beeldgeneratie die echte fouten veroorzaken:
Alleen hoofdletter K. Waarden met een kleine letter zoals 1k worden geweigerd.
Geen 512px op 2.1. Het kleinere formaat van 512px (0.5K) hoort bij Gemini 3.1 Flash Image, niet bij Nano Banana 2.1.
Beeldverhoudingen. De voorbeelden voor 2.1 gebruiken 1:1, 5:4 en 16:9. De modelpagina van Google noemt 1:4, 4:1, 1:8 en 8:1 als brede en panoramische verhoudingen waarbij tiling-artefacten zijn opgelost bij 2K en 4K. De pagina's die voor deze handleiding zijn gelezen, vermelden geen volledige lijst met verhoudingen voor 2.1, dus test de exacte verhouding die je nodig hebt voordat je er een lay-out op bouwt.
Pixelafmetingen. De handleiding van Google publiceert geen pixeltabel voor 2.1, dus meet het geretourneerde bestand als je lay-out vaste afmetingen nodig heeft.
Elke afbeelding die met de tools van Google wordt gegenereerd, bevat een SynthID-watermerk, volgens de handleiding. Houd daar rekening mee als je uitvoer nabewerkt of bijsnijdt.
Stem prompts af op 1K, want een groter formaat lost een zwakke compositie of een verkeerd gespeld woord niet op. Als je al een goede versie hebt en alleen meer pixels nodig hebt, vergroot de image upscaler deze zonder nieuwe generatie.
Referentieafbeeldingen: tot 14 per aanvraag
De Nano Banana 2.1 API accepteert tot 14 referentieafbeeldingen in één aanvraag, en het aantal is een totaal over alle typen. De gids van Google verdeelt de slots per model:
Type referentie
Nano Banana 2.1
Objecten (hoge getrouwheid in de uiteindelijke afbeelding)
Tot 10
Personages (consistentie tussen afbeeldingen)
Tot 4
Totaal
Tot 14
Elke referentie is nog een item in de lijst input. In het Python-voorbeeld van Google bevat een afbeeldingsitem "type": "image", de afbeeldingsbytes als base64 in data, en een mime_type zoals image/png, naast het tekstitem dat de prompt bevat.
Praktisch gebruik van de slots: geef elke afbeelding één taak en vermeld dit in de prompt (de eerste afbeelding is de productvorm, de tweede het kleurenpalet); hergebruik dezelfde personageafbeelding voor een terugkerend gezicht; en voeg referenties één voor één toe, want meer referenties garanderen niet dat elk detail behouden blijft.
Instellingen voor denkmodus en grounding
De Nano Banana 2.1 API kent drie denkmodusniveaus, ingesteld met generation_config.thinking_level: minimal, medium (de standaard) en high. De gids van Google zegt dat denkmodus standaard aan staat voor Gemini 3-afbeeldingsmodellen en niet kan worden uitgeschakeld via de API, dat het model maximaal twee tussentijdse denkafbeeldingen kan produceren, en dat denkmodustokens standaard worden gefactureerd. Andere Nano Banana-modellen vermelden andere niveaus (Nano Banana 2 vermeldt minimal en high), dus kopieer een instelling niet tussen modellen.
Grounding laat het model Google Search gebruiken voor tijdgevoelige onderwerpen. In de Interactions API voeg je tools toe met google_search, en met search_types van ["web_search", "image_search"] vraag je om web- en afbeeldingsresultaten; Image Search-grounding is alleen beschikbaar op Nano Banana 2.1 en Gemini 3.1 Flash Image. Google merkt op dat Image Search-resultaten met hun search_suggestions moeten worden weergegeven, dus bouw die weergave in je interface in.
Grounding wordt apart gefactureerd: de prijzenpagina van Google geeft 5,000 gratis zoekaanvragen per maand, gedeeld over Gemini 3 en nieuwere modellen, daarna $14 per 1,000 aanvragen. Controleer alle namen, cijfers of datums in een gegrounde afbeelding voordat je publiceert.
Multi-turn bewerken met previous_interaction_id
Om een afbeelding die je al hebt gegenereerd te wijzigen, stuur je een tweede aanvraag met previous_interaction_id ingesteld op de id van de eerste interactie en beschrijf je alleen de wijziging. In het voorbeeld van Google wordt de tekst van een infographic naar het Spaans vertaald, terwijl de andere elementen blijven zoals ze waren. Volgens het overzicht van de Interactions API zijn generation_config, tools en system_instruction gekoppeld aan één interactie, dus stel je ze bij elke beurt opnieuw in, en als je store op false zet, kun je previous_interaction_id niet meer gebruiken. Voor bewerkingen waarbij je met de hand over een gebied wilt schilderen, is de AI photo editor eenvoudiger dan het in woorden te beschrijven.
Prijzen voor de Nano Banana 2.1 API
Google factureert de Nano Banana 2.1 API op basis van tokens, en beeldoutput heeft een eigen tarief. Dit is de standaardprijslijst (betaalde laag) van de Gemini API-prijzenpagina, gelezen op 2026-10-10:
Item
Standaard
Batch
Input (tekst, afbeelding, video)
$1.50 per 1M tokens
$0.75 per 1M tokens
Output tekst en denkmodus
$7.50 per 1M tokens
$3.75 per 1M tokens
Output afbeeldingen
$30.00 per 1M image tokens
$15.00 per 1M image tokens
Eén 1K-afbeelding
$0.0336
$0.0168
Eén 2K-afbeelding
$0.0504
$0.0252
Eén 4K-afbeelding
$0.113
$0.0567
Grounding met Google Search
5,000 gratis aanvragen per maand, daarna $14 per 1,000
Niet apart vermeld
De prijzen per afbeelding zijn het tarief voor image tokens toegepast op de tokenaantallen uit de vorige sectie: 1,120 tokens tegen $30 per miljoen is $0.0336. De gratis laag staat voor dit model als niet beschikbaar vermeld, dus elke aanroep vereist een gefactureerd project.
Ter indicatie, met Google's prijzen voor alleen beeldoutput: 1,000 afbeeldingen kosten $33.60 bij 1K, $50.40 bij 2K en $113.00 bij 4K, of $25.20 bij 2K als batch. Invoertokens (je prompt en eventuele referentieafbeeldingen), denkmodus-tokens en grounding-aanvragen worden daarbovenop gefactureerd, dus meet een voorbeeldrun voordat je een budget vastlegt.
Snelheidslimieten en quota
De pagina over snelheidslimieten van Google vermeldt geen getal voor de Nano Banana 2.1 API. Het legt uit hoe limieten werken en verwijst je naar Google AI Studio voor de cijfers die van toepassing zijn op je project en tier.
Wat de pagina wel vermeldt:
Dimensies. Aanvragen per minuut (RPM), invoertokens per minuut (TPM) en aanvragen per dag (RPD); modellen die afbeeldingen genereren hebben ook afbeeldingen per minuut (IPM). Het overschrijden van één dimensie veroorzaakt een fout.
Bereik. Limieten gelden per project, niet per API-sleutel, en dagelijkse quota worden gereset om middernacht Pacific Time.
Niveaus. Gratis laag vereist een actief project, Tier 1 een gekoppeld factureringsaccount, Tier 2 $100 cumulatieve betaalde uitgaven plus 3 dagen, en Tier 3 $1,000 plus 30 dagen. Upgrades zijn automatisch.
Bestedingslimieten. Op besteding gebaseerde limieten gelden over een rollend venster van 10 minuten, en het bereiken van een limiet geeft een 429 RESOURCE_EXHAUSTED-fout.
Een loop die veel parallelle aanvragen afvuurt, kan een 429 krijgen lang voordat het dagelijkse quota is gebruikt. Voeg daarom retry met backoff toe, beperk de concurrency en stuur grote offline taken via de Batch API.
De modelpagina vermeldt ook 131,072 invoertokens en 32,768 uitvoertokens, en ondersteunt geen Flex- of Priority-inferentie.
Batch API voor Nano Banana 2.1
De modelpagina vermeldt de Batch API als ondersteund, en de prijzenpagina van Google prijst batch-afbeeldingsuitvoer op de helft van het standaardtarief: $0.0168 per 1K-afbeelding, $0.0252 per 2K-afbeelding en $0.0567 per 4K-afbeelding. De Batch API-gids stelt de beoogde doorlooptijd op 24 uur, hoewel deze in de meeste gevallen veel korter is. De afweging is wachttijd tegen prijs en hogere snelheidslimieten, wat geschikt is voor catalogusverversingen, prompttests en bulkvariaties in plaats van een interface waar een persoon op wacht.
Details uit de Batch API-gids: inline aanvragen moeten in totaal onder 20 MB blijven, terwijl grotere taken een JSONL-bestand (tot 2 GB) gebruiken met één aanvraag per regel en een key die je zelf definieert. Taken doorlopen JOB_STATE_PENDING, JOB_STATE_RUNNING en JOB_STATE_SUCCEEDED, of eindigen als mislukt, geannuleerd of JOB_STATE_EXPIRED; een taak die langer dan 48 uur in behandeling of actief is, verloopt. De pagina met snelheidslimieten vermeldt 100 gelijktijdige batchaanvragen en 20 GB bestandsopslag, plus limieten voor in de wachtrij geplaatste tokens per niveau.
Eén addertje onder het gras: de gids zegt dat batchverwerking alleen beschikbaar is met de generateContent API, en de afbeeldingsvoorbeelden gebruiken responseModalities ingesteld op ["TEXT", "IMAGE"] met een ander Nano Banana model-ID. Er is geen voorbeeld voor gemini-nano-banana-2.1, dus voer een kleine testbatch uit met dit model-ID voordat je duizenden aanvragen indient. In de praktijk draait interactief bewerken op de Interactions API en bulk offline generatie op generateContent batches.
Migreren naar Nano Banana 2.1 vanaf eerdere modellen
Op de prijzenpagina van Google staat de originele Nano Banana, gemini-2.5-flash-image, als verouderd gemarkeerd met een afsluitdatum van 2 oktober 2026, en de handleiding voor beeldgeneratie beveelt Nano Banana 2.1 aan voor nieuwe projecten. Controleer deze verschillen wanneer u het model-ID wijzigt. 2.1 vermeldt denkniveaus minimal, medium en high, terwijl 3.1 Flash Image minimal en high vermeldt. Het 512px-formaat bestaat op 3.1 Flash Image maar niet op 2.1, dus vraag om 1K en herschaal aan uw kant. Image Search-grounding werkt op 2.1 en 3.1 Flash Image, en Flash Lite heeft geen search-grounding. 2.1 ondersteunt geen function calling of gestructureerde outputs, dus verplaats elke JSON-producerende stap naar een tekstmodel. Herbereken uw kostenraming met de 2.1-tarieven hierboven, voer vervolgens uw opgeslagen prompts uit met het nieuwe model en vergelijk de resultaten met de oude, want een modelwijziging verandert de stijl en tekstweergave zelfs bij identieke prompts.
Nano Banana 2.1 gebruiken zonder de API
Als je doel een afbeelding is in plaats van een integratie, is de browser eenvoudiger. Potto's AI image generator biedt Nano Banana 2.1 met HD, 2K en 4K uitvoer, tot 10 referentieafbeeldingen en PNG- of JPEG-bestanden. Omdat Potto geen publieke API heeft, is dit alleen een webworkflow.
Potto prijst afbeeldingen in credits, getoond op de Generate-knop voordat je bevestigt. Nano Banana 2.1 kost 12 credits per afbeelding bij HD, 17 bij 2K en 38 bij 4K, en een mislukte aanvraag geeft de credits vrij. Credits zijn Potto's eigen eenheid, geen omrekening van Google's dollarprijzen, dus vergelijk de twee niet alsof het dezelfde valuta zijn. De Potto AI prijzen pagina toont de abonnementen, en de AI modellen pagina vergelijkt elk afbeeldingsmodel in de creator, inclusief Nano Banana en Nano Banana Pro.
De workflows spiegelen de API: text to image is een aanvraag met alleen een tekstitem, image to image AI voegt je eigen afbeelding toe als een afbeeldingsitem in input, de AI-personagegenerator richt zich op terugkerende personages, en afbeeldingssjablonen geven je een opdracht om aan te passen.
API of webgenerator: welke moet je gebruiken?
Gebruik de Gemini API wanneer afbeeldingen binnen je eigen product of volgens een schema worden gemaakt: een webshop die voor elke productvermelding een variatie rendert, een nachtelijke taak tegen batchtarieven, of een app waarin gebruikers een prompt typen. Jij beheert de sleutels, herhaalpogingen, opslag en facturering, en je krijgt de volledige parameterset van Google.
Gebruik de webgenerator wanneer een persoon de afbeeldingen maakt: een campagneaffiche, productfoto's, een mascotte voor een presentatie. Er is geen sleutel om te beheren en geen response om te parsen, en de prijs wordt vóór elke generatie getoond. Je kunt ook een prompt in de browser verkennen en de winnende formulering later naar een API-aanroep overzetten.
Veelgestelde vragen
Wat is de Nano Banana 2.1 API?
De Nano Banana 2.1 API is de manier om Google's gemini-nano-banana-2.1-beeldmodel via de Gemini API aan te roepen. Het accepteert tekst-, afbeeldings-, video- of PDF-invoer, geeft afbeeldingen en tekst terug en ondersteunt uitvoer van 1K, 2K en 4K, tot 14 referentieafbeeldingen, configureerbare denkmodus en grounding met Google Search. Het is geen apart product: je gebruikt een Gemini API-sleutel en noemt het model-ID in je aanvraag.
Wat is het model-ID van Nano Banana 2.1?
Het model-ID is gemini-nano-banana-2.1. Op de modelpagina van Google staat dat de stabiele versie hetzelfde ID gebruikt, dus je hebt geen versiesuffix nodig. Andere Nano Banana-modellen hebben hun eigen ID's, zoals gemini-3.1-flash-image voor Nano Banana 2, dus controleer het ID wanneer je van model wisselt.
Hoeveel kost de Nano Banana 2.1 API?
Bij standaardprijzen rekent Google $0.0336 per 1K-afbeelding, $0.0504 per 2K-afbeelding en $0.113 per 4K-afbeelding, plus tokenkosten voor invoer en denkmodus. Batchtaken kosten de helft: $0.0168, $0.0252 en $0.0567. Dit zijn cijfers van de Gemini API-prijzenpagina van Google zoals gelezen op 2026-10-10, en de gratis laag staat als niet beschikbaar voor dit model.
Hoeveel referentieafbeeldingen kan Nano Banana 2.1 gebruiken?
Tot 14 in één aanvraag: tot 10 objectafbeeldingen en tot 4 personageafbeeldingen. Google telt het totaal over de typen, dus een aanvraag mag niet meer dan 14 zijn, zelfs als beide limieten worden gebruikt. Geef elke referentie één taak in de prompt en controleer de details die je belangrijk vindt in het resultaat.
Heeft Potto een Nano Banana 2.1 API?
Nee. Potto biedt geen publieke API. Je kunt Nano Banana 2.1 gebruiken in de webgenerator van Potto voor 12 credits per afbeelding bij HD, 17 bij 2K en 38 bij 4K. Ontwikkelaars die het model vanuit code willen aanroepen, kunnen het beste de Gemini API van Google met het model-ID gemini-nano-banana-2.1 gebruiken.
Wat zijn de snelheidslimieten voor de Nano Banana 2.1 API?
Google publiceert geen getal voor dit model op zijn snelheidslimietenpagina. Limieten worden gemeten in aanvragen per minuut, invoertokens per minuut, aanvragen per dag en, voor beeldmodellen, afbeeldingen per minuut, en ze gelden per project en zijn afhankelijk van je gebruiksniveau. Open de weergave voor snelheidslimieten in Google AI Studio voor de cijfers die voor jouw account gelden.
Kan ik de Batch API met Nano Banana 2.1 gebruiken?
Ja. Google vermeldt de Batch API als ondersteund op de modelpagina en rekent voor batchafbeeldingen de helft van het standaardtarief, met een beoogde doorlooptijd van 24 uur. Batchverwerking is alleen beschikbaar met de generateContent API, niet met de Interactions API, en de voorbeelden voor batchafbeeldingen van Google gebruiken een ander Nano Banana-model-ID, dus test eerst een kleine batch met gemini-nano-banana-2.1.
Bronnen
Alle bronnen zijn gelezen op 2026-10-10. Prijzen, limieten en modeldetails zijn afkomstig van Google en kunnen veranderen.
