Hoe Nano Banana Pro/Nano Banana 2 API te gebruiken — Stapsgewijze handleiding voor ontwikkelaars

Als je hebt gezocht op “Nano Banana Pro API”, is de naam het eerste wat verwarring kan wekken. De productnaam is Nano Banana Pro. De naam van de API die je daadwerkelijk in de code gebruikt, is gemini-3-pro-beeld. Als dat eenmaal duidelijk is, is de rest van de installatie een stuk minder mysterieus.

Gebruik Nano Banana Pro wanneer het geheel een samenhangend geheel moet vormen: leesbare tekst, productdetails, merkverwijzingen, aangepaste lay-outs of een visuele opdracht met veel kleine beperkingen. Als je nog steeds tien varianten van hetzelfde idee aan het uitproberen bent, begin dan eerst met Nano Banana 2 en stap over op Pro wanneer de richting de moeite waard is om er meer in te investeren.

Als je team nog steeds bezig is met het opstellen van prompts in plaats van een app uit te brengen, De Nano Banana Pro-werkruimte van GlobalGPT is een handige manier om resultaten te vergelijken voordat een ontwikkelaar de officiële API implementeert. Het is een creatieve snelkoppeling in de workflow, maar geen vervanging voor de API-console, facturering, logboeken of bedrijfsbeheerfuncties van Google.

Kort antwoord

Om Nano Banana Pro via een API te gebruiken, moet je een Google AI Studio- of Google Cloud-project aanmaken, een Gemini-API-sleutel genereren, de Google Gen AI SDK installeren en vervolgens de API aanroepen gemini-3-pro-beeld. Begin met één verzoek om tekst om te zetten in een afbeelding. Als je nog steeds de toegang controleert voordat je een API bouwt, dan is de Stapsgewijze handleiding voor de gratis proefversie van Gemini 3 Pro is een nuttige aanvulling.

Wat de Nano Banana Pro API nu eigenlijk is

Nano Banana Pro is het hoogwaardige native model voor het genereren van afbeeldingen van Google binnen de Gemini-afbeeldingsfamilie. In de documentatie voor ontwikkelaars noemt Google het Gemini 3 Pro Afbeelding. Daarom ziet de modelstring er anders uit dan de marketingnaam.

De API kan een afbeelding genereren op basis van tekst, gebruikmaken van een of meer referentieafbeeldingen en een bestaande afbeelding bewerken volgens schriftelijke instructies. Daardoor is de API handig voor productmodellen, advertentievarianten, diagrammen, gelokaliseerde advertenties en afbeeldingsworkflows waarbij de tekst in de afbeelding leesbaar moet blijven; voor het verkennen van mogelijkheden zonder te programmeren, de GlobalGPT-beeldgenerator is de plek waar je de creatieve koers het gemakkelijkst eerst kunt uittesten.

Nano Banana Pro versus Nano Banana 2

De keuze hangt niet zozeer af van welke naam moderner klinkt, maar meer van in welke fase van het werk je je bevindt. ‘Pro’ is voor de zorgvuldige doorloop. ‘Nano Banana 2’ is voor de rommelige conceptfase; als je die snellere aanpak nodig hebt, lees dan de Nano Banana: handleiding voor 2 gratis proefperiodes voordat je de hele workflow rond Pro gaat ontwerpen.

Configureer de API met de daadwerkelijke toegangspunten

Voor een prototype is Google AI Studio meestal de snelste manier. Voor een bedrijfsapp kun je het beste de Google Cloud-opstelling gebruiken waar je team al vertrouwen in heeft, vooral als je behoefte hebt aan gezamenlijke facturering, toegangscontrole, logboekregistratie of Vertex AI-governance. Als de keuze voor toegang echt afhangt van de verschillende abonnementsniveaus van Google, vergelijk dan de voor- en nadelen in de Vergelijking tussen Google AI Plus en Pro: een handleiding voordat we de configuratie van de API als het enige probleem beschouwen.

De openbare documentatie is de meest overzichtelijke eerste stap. Hiermee kun je controleren of je op de pagina voor het genereren van Nano Banana-images bent, nagaan of de pagina het aanbevolen Interactions API-pad gebruikt, en van daaruit doorklikken naar de API-sleutel of de toegangspunten van AI Studio.

1. Maak een Google AI Studio- of Google Cloud-project aan of open er een.
2. Maak een Gemini-API-sleutel aan.
3. Sla de sleutel op als een omgevingsvariabele aan de serverzijde.
4. Installeer de Google Gen AI SDK in je backend-project.
5. Voer eerst één test met lage resolutie uit voordat je referentieafbeeldingen of functies voor de gebruiker toevoegt.

De pagina met API-sleutels is ook openbaar, maar of je een sleutel kunt aanmaken of bekijken, hangt af van je Google-account en je projectrechten. Het belangrijkste is: zorg ervoor dat die sleutel niet in het frontend-JavaScript terechtkomt. Een browser of mobiele app moet je backend aanroepen, en je backend moet Gemini aanroepen.

Na het inloggen wordt de directe URL van AI Studio inderdaad in Playground geopend met Nano Banaan Pro geselecteerd als gemini-3-pro-beeld. In dit verslag bracht AI Studio ook een praktisch knelpunt aan het licht: voor de Nano Banana Pro is een Google AI-abonnement of een API-sleutel nodig voordat de Playground het programma kan uitvoeren.

De Code ophalen Het is op dit moment nog steeds de moeite waard om op de knop te klikken. Dit bevestigt dat je je in de ontwikkelaarsworkflow bevindt, maar als het model voor het account is vergrendeld, kan het codepaneel worden geopend zonder een volledig uitvoerbaar fragment. Dat is een aanwijzing voor de configuratie, geen bug in de prompt.

export GEMINI_API_KEY="YOUR_API_KEY"

Een eerste afbeelding genereren

Het eerste verzoek moet bewust eenvoudig zijn. Je controleert de authenticatie, de toegang tot het model, de vorm van het antwoord en de bestandsverwerking. Ingewikkelde prompt-bewerkingen kunnen wachten tot alles goed op orde is.

from google import genai
from google.genai import types
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=(
 "Maak een strakke productmockup van een roestvrijstalen reisbeker "
 "op een wit bureau. Voeg het leesbare label toe: MORNING LAB."
    ),
    config=types.GenerateContentConfig(
 response_modalities=["TEXT", "IMAGE"]
    ),
)

for part in response.candidates[0].content.parts:
    if part.text:
 print(part.text)
    elif part.inline_data:
 with open("nano-banana-pro-output.png", "wb") as f:
 f.write(part.inline_data.data)

Deze opdracht vraagt om een eenvoudige productmock-up met leesbare tekst. Dat geeft je meteen inzicht in drie zaken die in de praktijk van belang zijn: het realisme van het object, de compositie en de vraag of het model korte tekst scherp kan weergeven. Probeer voor het vormgeven van opdrachten zonder de specificaties aan te passen eens dezelfde opdracht in De Nano Banana Pro-werkruimte van GlobalGPT eerst.

Afbeeldingen bewerken met bronvermeldingen

Bij het bewerken op basis van referentiebeelden komt Nano Banana Pro pas echt tot zijn recht. In plaats van het model te vragen een geheel nieuwe afbeelding te maken, geef je het model een afbeelding en geef je precies aan wat er mag veranderen en wat hetzelfde moet blijven.

Als je geen ontwikkelaar bent, beschouw dit blok dan als een voorbeeld van een werkstroom en niet als iets dat je daadwerkelijk moet uitvoeren. De bestandsnaam product-reference.png betekent simpelweg “je bestaande productafbeelding”. Als je je vooral bezighoudt met het vergelijken van afbeeldingsmodellen, dan is de bredere Test van alternatieven voor de Gemini 3 Pro kan je helpen beslissen of Pro de extra installatie de moeite waard is.

from google import genai
from google.genai import types
from PIL import Image
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
reference = Image.open("product-reference.png")

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=[
 reference,
 (
 "Laat de vorm van de mok, het oor en de plaatsing van het logo ongewijzigd. "
            "Verander de achtergrond in een licht aanrechtblad, voeg warm ochtendlicht toe, "
 "en zorg dat alle tekst scherp en leesbaar blijft."
 ),
    ],
    config=types.GenerateContentConfig(response_modalities=["TEXT", "IMAGE"]),
)

Een goede aanwijzing voor een bewerking klinkt bijna als feedback aan een ontwerper: behoud dit, verander dat, verplaats het logo niet, zorg dat de tekst leesbaar blijft. Vage instructies zoals “maak het wat luxer” leiden vaak tot verspilde opdrachten, omdat het model te veel moet raden.

Prijsstelling en kostenbeheersing

Gebruik de prijspagina van Google als betrouwbare bron voordat je vaste budgetcijfers publiceert. Zoals op 21 juli 2026 is gecontroleerd, vermeldt Google Nano Banana Pro onder Gemini 3 Pro Image en maakt het een onderscheid tussen de kosten voor tekst/denken en de kosten voor beeldoutput.

Kosten voor API-afbeeldingsuitvoer, gecontroleerd op 21 juli 2026

Het praktische kostenpatroon is eenvoudig: goedkoper ontwerpen, zorgvuldig afwerken. Laat Nano Banana 2 de eerste variaties afhandelen en stuur vervolgens de sterkste prompts en referenties naar Nano Banana Pro voor de definitieve afbeeldingen. Beperk ook de resolutie per gebruikersniveau en vermijd herhaalde generaties wanneer de prompt niet is gewijzigd; als je een ontwerpspoor aan de productzijde wilt, Nano Banana 2 in GlobalGPT is de lichtere optie die je het beste eerst kunt uitproberen.

Productienotities

Zodra gebruikers afbeeldingen kunnen genereren op basis van uw product, zijn er waarborgen nodig. API’s voor afbeeldingen kunnen al snel duur worden, en storingen moeten verklaarbaar zijn zonder dat de ruwe gegevens van de aanbieder worden blootgegeven. Teams die nog aan het bepalen zijn wie toegang tot betaalde AI nodig heeft, kunnen ook workflows op basis van abonnementen vergelijken in de ChatGPT Handleiding voor het opstellen van een bedrijfsplan.

• Bewaar sleutels op de server: Verzend de Gemini API-sleutel niet via een browser of mobiele client.
• Log voldoende gegevens om fouten op te sporen: model-ID, prompt-hash, uitvoergrootte, latentie, gebruikers-ID en resultaatstatus.
• Quota instellen: het aantal afbeeldingen per gebruiker, werkruimte en factureringsperiode beperken.
• Probeer het nog eens, maar wees voorzichtig: Probeer tijdelijke storingen opnieuw, maar probeer fouten met betrekking tot het beleid of de quota niet herhaaldelijk in een lus.
• Stel opslagregels vast: Weet hoe lang u gegenereerde afbeeldingen en geüploade referentiematerialen bewaart.
• Geef duidelijke foutmeldingen: laat de gebruiker weten of het probleem te maken heeft met toegang, het bestandsformaat, de quota of het promptbeleid.

Waar GlobalGPT van pas komt

GlobalGPT past het beste vóór of naast de API-build. Een ontwerper kan Nano Banana Pro vergelijken met Nano Banaan 2, GPT Image, Flux en andere beeldmodellen in één werkruimte, en geef vervolgens het beste promptpatroon door aan de ontwikkelaar.

Voor officiële API-sleutels, facturering, logbestanden, toegang voor bedrijven of Vertex AI-routing kun je het beste het ontwikkelaarsplatform van Google blijven gebruiken. Voor een snellere vergelijking van creatieve ideeën en minder tabbladen tijdens het ontwikkelen van prompts, De werkruimte van de beeldgenerator van GlobalGPT kan ervoor zorgen dat het vroege werk minder onhandig overkomt.

FAQ

Is de Nano Banana Pro API hetzelfde als de Gemini 3 Pro Image?

Voor ontwikkelaarswerk, ja. Google beschrijft de Nano Banana Pro als Gemini 3 Pro Image, en de API-model-ID is gemini-3-pro-beeld.

Moet ik de Nano Banana Pro of de Nano Banana 2 gebruiken?

Gebruik Nano Banana Pro voor definitieve afbeeldingen waarbij nauwkeurigere controle, leesbare tekst, bronvermeldingen of merkconsistentie vereist zijn. Gebruik Nano Banana 2 voor snellere concepten en goedkopere iteraties.

Kan ik Nano Banana Pro rechtstreeks vanuit JavaScript in de frontend aanroepen?

Nee. Bewaar de API-sleutel op de server, leid verzoeken via je backend en pas gebruikersquota toe voordat je verzoeken naar de Gemini-API verstuurt.

Vervangt GlobalGPT de officiële Google-API?

Nr. GlobalGPT is handig voor het snel testen en het vergelijken van creatieve uitkomsten uit verschillende modellen, maar officiële API-sleutels, facturering, logbestanden en beheerfuncties voor bedrijven horen thuis op het ontwikkelaarsplatform van Google.

Hoe kan ik de kosten van de Nano Banana Pro API inschatten?

Gebruik de huidige prijspagina van de Gemini API van Google en maak een schatting op basis van het model, de uitvoerresolutie en het beeldvolume. Een veelgebruikte methode om de kosten te beheersen is om eerst een concept te maken met het goedkopere model en vervolgens Nano Banana Pro te gebruiken voor geselecteerde definitieve beelden.