Gemini Image API migreren: actuele modellen en stappen (2026)

Gebruik voor een nieuwe Gemini Image API-koppeling in de meeste gevallen gemini-3.1-flash-image, niet een oude Imagen- of preview-modelnaam. Plan de migratie nu: Google noemt 17 augustus 2026 als vroegst mogelijke stopdatum voor de huidige Imagen 4-endpoints en 2 oktober 2026 voor gemini-2.5-flash-image.

Een model-ID vervangen is maar één deel van de migratie. Controleer ook de SDK, requestvorm, afbeeldingsuitvoer, veiligheidsfilters, quota en de kwaliteit van je eigen beelden. Deze gids onderscheidt de actuele, stabiele modelnamen van oude preview-namen en helpt je gecontroleerd omschakelen.

In het kort

• Kies voor de meeste nieuwe integraties gemini-3.1-flash-image (Nano Banana 2), een stabiel model voor beeldgeneratie en beeldbewerking.
• Kies gemini-3.1-flash-lite-image (Nano Banana 2 Lite) als snelheid en efficiëntie zwaarder wegen dan maximale flexibiliteit. Dit model ondersteunt alleen 1K-uitvoer.
• Kies gemini-3-pro-image (Nano Banana Pro) voor complexe professionele beeldopdrachten en nauwkeurige creatieve controle.
• Vervang gemini-3.1-flash-image-preview en gemini-3-pro-image-preview door hun stabiele tegenhangers. Google vermeldt dat deze preview-endpoints op 25 juni 2026 zijn gestopt.
• Migreer Imagen 4-endpoints vóór 17 augustus 2026 en gemini-2.5-flash-image vóór 2 oktober 2026. Google behandelt die datums als vroegst mogelijke stopdatums.
• Gebruik bij oude clientbibliotheken de actuele Google GenAI SDK en test de volledige aanvraag en respons, niet alleen de modelnaam.

Wil je eerst de modellen in gewone taal vergelijken? Bekijk dan Gemini-afbeeldingen maken, de Gemini-hub en de vergelijking van AI-modellen.

Welke model-ID vervangt je huidige endpoint?

Google heeft op 28 mei 2026 de stabiele versies van gemini-3.1-flash-image en gemini-3-pro-image uitgebracht. De actuele modelspecificatie van Gemini 3.1 Flash Image noemt gemini-3.1-flash-image expliciet als stabiele model-ID. Gebruik geen oude blogpost, voorbeeldrepository of gekopieerde preview-configuratie als bron voor je productie-ID.

De Gemini-deprecationstabel is leidend voor lifecycle-data. Google schrijft daar dat een stopdatum de vroegst mogelijke datum is en dat de precieze datum vooraf kan worden gecommuniceerd. Controleer die tabel daarom opnieuw vlak vóór je productie-release.

Kies op taak, niet op de bijnaam

Google gebruikt de bijnaam Nano Banana voor deze beeldmodellen. Gebruik in code altijd de model-ID, niet alleen de bijnaam.

Volgens Googles handleiding voor afbeeldingsgeneratie genereert de Gemini 3-familie standaard 1K en kan Flash Image ook 0.5K, 2K en 4K leveren. Lite ondersteunt alleen 1K. Vraag een groter formaat expliciet aan en gebruik hoofdletter K, bijvoorbeeld 2K, want een kleine letter wordt afgewezen.

Stappenplan voor een veilige migratie

Stap 1: inventariseer alles wat je werkelijk aanroept

Zoek niet alleen naar de modelnaam. Noteer per toepassing:

1. de API-route: Gemini API of Vertex AI;
2. de gebruikte SDK en versie;
3. model-ID en eventuele versie- of preview-achtervoegsels;
4. requestvelden voor formaat, resolutie, referentiebeelden en veiligheid;
5. hoe je afbeeldingsdata opslaat, scant en aan de gebruiker toont;
6. quota, foutmeldingen, retries en logging.

Gemini API en Vertex AI delen modellen, maar zijn geen uitwisselbare implementatiedetails. Houd de documentatie en lifecycle van jouw gekozen platform aan. De Vertex AI release notes zijn nuttig naast de Gemini API-documentatie wanneer je op Vertex AI draait.

Stap 2: vervang preview- en uitgefaseerde namen bewust

Zet de nieuwe model-ID eerst in een configuratievariabele of feature flag. Zo kun je één gecontroleerde release doen en terugdraaien zonder een codewijziging onder druk. Pin bij voorkeur een specifieke, stabiele ID in plaats van een latest-alias, tenzij je expliciet hebt ingericht dat nieuwe modelversies automatisch mogen veranderen.

Voorbeeld van de actuele Gemini API-vorm voor één afbeelding met de Google GenAI SDK:

import { GoogleGenAI } from '@google/genai'

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY })

const interaction = await ai.interactions.create({
  model: 'gemini-3.1-flash-image',
  input: 'Maak een rustige liggende illustratie van een teamoverleg, zonder logo’s.',
  response_format: {
    type: 'image',
    aspect_ratio: '16:9',
    image_size: '2K',
  },
})

const imageBase64 = interaction.output_image?.data
if (!imageBase64) throw new Error('Geen afbeeldingsuitvoer ontvangen')

Dit is een klein uitgangspunt, geen compleet productiepatroon. Bewaar de API-sleutel alleen aan de serverkant, valideer de invoer, stel tijdslimieten in en behandel een ontbrekende afbeelding als een normale foutafhandelingsroute. De officiële voorbeeldcode voor Image Generation blijft de bron voor actuele veldnamen en response-formaten.

Stap 3: migreer de clientbibliotheek als dat nodig is

De huidige Google GenAI SDK gebruikt in JavaScript @google/genai en in Python google-genai. De migratiegids van Google adviseert ontwikkelaars met de oudere bibliotheken om over te stappen en toont dat de nieuwe SDK via één client werkt.

Combineer dit niet zonder test met alleen een modelwissel. Maak in een aparte branch eerst een klein adapterpunt dat de nieuwe client aanroept. Dan kun je de rest van je applicatie tijdelijk dezelfde interne functie laten gebruiken en zie je precies welke velden in de respons zijn veranderd.

Stap 4: maak een kleine vaste beeldtestset

Een API-call die technisch slaagt, bewijst nog niet dat de migratie goed is. Maak minimaal vijf opdrachten die je ook na een modelupdate opnieuw kunt draaien:

1. een eenvoudige illustratie zonder tekst;
2. een bestaande afbeelding met één gerichte bewerking;
3. een beeld met korte Nederlandse tekst die je handmatig controleert;
4. een opdracht met het voor jouw werk typische formaat;
5. een foutscenario, bijvoorbeeld een ongeldige invoer of een overschreden limiet.

Leg per test prompt, referentie-invoer, model-ID, datum, API-route, resultaat en handmatige beoordeling vast. Beoordeel niet alleen esthetiek, maar ook foutmeldingen, doorlooptijd, formaat, ongewenste tekst, merk- of persoonsverwarring en de manier waarop je product omgaat met een geblokkeerde of lege respons.

Stap 5: voer gecontroleerd uit en bewaak de overgang

Start met een klein deel van het verkeer of een interne gebruiker. Meet foutpercentages, responstijd, uitval van uitvoer en de correctielast. Houd de oude route alleen zolang vast als dat binnen de aangekondigde lifecycle kan, en verwijder daarna achtergebleven preview- en Imagen-namen uit configuratie, documentatie en monitoring.

Voor terugkerende productiestappen is alleen een modelkeuze onvoldoende. De dienst AI-automatisering helpt bij de afbakening van invoer, controles en overdracht. Voor bredere technische koppelingen vind je ook hulp bij automatisering binnen het Hulpbij-netwerk.

Wat verandert er functioneel?

Vergelijk niet uitsluitend de pixels. De actuele modellen hebben andere mogelijkheden en grenzen. Gemini 3.1 Flash Image ondersteunt afbeeldingsgeneratie, zoek-grounding en thinking, maar de modelspecificatie vermeldt bijvoorbeeld geen function calling of structured outputs. Dat is relevant als je huidige workflow een beeldcall in een grotere geautomatiseerde keten gebruikt: laat de applicatie de controle, validatie en actie-autorisatie regelen.

Gebruik zoek-grounding alleen wanneer actuele externe informatie echt nodig is. Controleer de gemaakte afbeelding en de broncontext vervolgens apart. Een gegenereerde grafiek, kaart of actualiteitsvisual is geen vervanging voor een broncontrole.

Ook betere tekstweergave is geen publicatiegarantie. Laat koppen, bedragen, datums, productnamen en juridische claims door een mens controleren. Upload alleen referentiebeelden waarvoor je toestemming hebt en behandel klant- of medewerkersfoto's als persoonsgegevens.

Veelgemaakte fouten

Een oude preview-naam als einddoel kiezen

gemini-3.1-flash-image-preview en gemini-3-pro-image-preview zijn niet de namen voor een nieuwe productieconfiguratie. Google markeert ze als uitgefaseerd en verwijst naar de stabiele modelnamen zonder -preview.

Alleen de modelstring vervangen

Een nieuwe model-ID kan samengaan met een nieuwere SDK, andere response-structuur en andere standaardinstellingen. Test daarom ook de client, parser, opslag, foutafhandeling en observability.

Een stopdatum als veilige deadline behandelen

Google beschrijft lifecycle-datums als vroegst mogelijke stopdatums. Wacht dus niet tot de laatste week. Plan tijd voor regressietests, herstel en een tweede controle van de officiële documentatie.

Resolutie veronderstellen

Lite ondersteunt alleen 1K. Voor Flash Image of Pro moet je hogere resolutie expliciet vragen. Controleer bovendien of het resultaat bij je eigen afdruk-, web- of social-formaat past.

De beeldcall zelfstandig laten publiceren

Een succesvolle API-respons is geen goedkeuring voor publicatie. Voeg een menselijk controlemoment toe voor merk, rechten, privacy, feitelijke inhoud en context. Voor een keten met meerdere systemen is de gids AI-workflows automatiseren een bruikbaar vertrekpunt.

Wanneer schakel je een Gemini-expert in?

Schakel hulp in wanneer de koppeling klantgegevens of referentiefoto's verwerkt, wanneer beeldoutput direct wordt gepubliceerd, of wanneer je Gemini met CMS, CRM, Drive of een workflowtool verbindt. Dan moet je naast de API-call ook rollen, toestemming, logging, herstel en menselijke beoordeling ontwerpen.

Wil je de modelkeuze, migratie en controles laten beoordelen? Bespreek je situatie met een AI-expert voor Gemini en andere AI-toepassingen. Voor een losse productoriëntatie kun je verder in de Gemini-hub; voor een technische workflow met een duidelijke eigenaar bij AI-automatisering.

Veelgestelde vragen

Welk Gemini-model gebruik ik nu voor afbeeldingsgeneratie?

Voor de meeste nieuwe Gemini API-koppelingen is gemini-3.1-flash-image de actuele stabiele algemene keuze. Kies gemini-3.1-flash-lite-image wanneer lage latentie en efficiëntie zwaarder wegen, en gemini-3-pro-image voor complexe professionele beeldopdrachten. Test altijd met je eigen invoer en account.

Wanneer stopt gemini-2.5-flash-image?

Google noemt 2 oktober 2026 als vroegst mogelijke stopdatum voor gemini-2.5-flash-image. De documentatie kan een exacte datum vooraf bevestigen, maar plan de migratie ruim voor die datum en controleer de actuele deprecationstabel opnieuw voor je release.

Moet ik Imagen naar Gemini Image migreren?

Ja, voor de Imagen-modellen die Google in de Gemini API noemt. Google vermeldt 17 augustus 2026 als vroegst mogelijke stopdatum voor imagen-4.0-generate-001, imagen-4.0-ultra-generate-001 en imagen-4.0-fast-generate-001, met gemini-3.1-flash-image als aanbevolen vervanging.

Moet ik ook van SDK wisselen?

Als je nog een oudere Google-generative-AI-client gebruikt, adviseert Google migratie naar de Google GenAI SDK. Dat is een aparte wijziging naast het vervangen van de model-ID. Test daarom de SDK, de requestvorm en de verwerking van de afbeeldingsuitvoer samen.

Is gemini-3.1-flash-image-preview nog een goed migratiedoel?

Nee. Google noteert gemini-3.1-flash-image-preview als uitgefaseerd met gemini-3.1-flash-image als vervanging. Gebruik geen preview-naam uit oude voorbeelden als nieuwe vaste productieconfiguratie.

Kan ik dezelfde prompt en instellingen ongewijzigd laten?

Dat is niet verstandig. Nieuwe modellen en API-versies kunnen andere requestvelden, standaarden, limieten en resultaten hebben. Leg een kleine vaste testset vast en controleer beeldkwaliteit, formaat, foutafhandeling, veiligheid en kosten voordat je omschakelt.

Bronnen

• Google AI for Developers: Image generation with Gemini
• Google AI for Developers: Gemini deprecations
• Google AI for Developers: Gemini 3.1 Flash Image
• Google AI for Developers: Migrate to the Google GenAI SDK
• Google Cloud Vertex AI: release notes

Laatst inhoudelijk gecontroleerd: 4 augustus 2026.