Gemini API: welke bestandsgroottes en invoermethoden worden momenteel ondersteund?

Op 12 januari 2026 publiceerde Google een ontwikkelaarsupdate voor de Gemini API die verandert hoe je bestanden in het model aanlevert en hoe groot die bestanden mogen zijn. Kort samengevat: Gemini kan nu bestanden rechtstreeks ophalen van externe links en cloudopslag (zodat je ze niet altijd hoeft te uploaden), en de limiet voor inline bestandsgrootte is aanzienlijk verhoogd. Deze updates halen wrijving weg voor echte apps die media of documenten al in cloud-buckets opslaan en maken korte prototyping- en productie-workflows sneller en goedkoper.

CometAPI biedt Gemini API’s zoals Gemini 3 Pro en gemini 3 flash, en het heeft een aantrekkelijke prijs.

Belangrijkste updates — wat is er nieuw in de Gemini API?

Leest externe bestandslinks rechtstreeks
— Gemini kan bestanden ophalen van:
- Publieke HTTPS-URL’s en ondertekende URL’s (S3 presigned URLs, Azure SAS, enz.).
- Google Cloud Storage (GCS) objectregistratie (registreer een GCS-object één keer en hergebruik het).
Grotere inline bestandsgrootte — de limieten voor inline (in-request) payloads zijn verschoven van 20 MB → 100 MB (opmerking: sommige bestandstypen, zoals pdf’s, kunnen iets andere effectieve limieten hebben zoals in de documentatie vermeld).
Files API & batch-richtlijnen ongewijzigd voor zeer grote bestanden — Voor bestanden die je wilt hergebruiken of groter zijn dan de inline/externe limieten, blijf de Files API gebruiken (max 2 GB per bestand, projecten kunnen tot 20 GB aan Files API-opslag bevatten; geüploade bestanden worden standaard 48 uur bewaard). GCS-registratie ondersteunt ook grote bestanden (2 GB per bestand) en kan worden geregistreerd voor hergebruik.
Modelcompatibiliteit — sommige oudere modelfamilies of gespecialiseerde varianten kunnen andere ondersteuning hebben (de documentatie noemt uitzonderingen, zoals bepaalde modellen in de Gemini 2.0-familie voor sommige file-URI-workflows). Controleer altijd de model-specifieke documentatie voordat je grote assets verzendt.

Waarom zijn de wijzigingen in de bestandsverwerking van de Gemini API belangrijk?

Voor deze update moest je, als je wilde dat de Gemini API (Google’s AI-model) bestanden analyseerde zoals: een pdf-rapport; een video; een audiobestand; of enkele afbeeldingen; die bestanden eerst uploaden naar de tijdelijke opslag van Gemini.

En:

geüploade bestanden werden na 48 uur verwijderd;
bestanden mochten niet te groot zijn (maximaal 20 MB);
als je bestanden al in de cloud stonden (zoals GCS, S3 of Azure), moest je ze opnieuw uploaden — zeer onhandig.

Dat verdubbelde de inspanning voor ontwikkelaars, verhoogde de bandbreedtekosten, introduceerde latentie en maakte echte gebruiksscenario’s (lange opnames, handleidingen met meerdere pagina’s, afbeeldingen met hoge resolutie) soms onpraktisch. De combinatie van grotere inline payloads plus de mogelijkheid om Gemini naar bestaande opslag te wijzen (via publieke of ondertekende URL’s, of geregistreerde GCS-objecten) verkort het pad van “data” naar “bruikbare modeloutput” drastisch:

Zero-copy-efficiëntie: Doordat Gemini direct kan lezen uit je bestaande storage-buckets (GCS) of externe URL’s (AWS S3, Azure), elimineer je de “ETL-belasting”. Je hoeft een bestand niet meer naar je backend te downloaden om het vervolgens opnieuw naar Google te uploaden. Het model gaat naar de data, niet andersom.
Stateless architectuur: De verhoogde inline limiet van 100 MB maakt krachtigere “stateless” verzoeken mogelijk. Je hoeft de levenscyclus van een file-ID niet te beheren of je zorgen te maken over het opruimen van oude uploads bij elke interactie.
Multi-cloud-agnostisch: De ondersteuning voor ondertekende URL’s zorgt dat de Gemini API goed samenwerkt met datalakes op AWS of Azure. Dit is een enorme winst voor enterprises met multi-cloudstrategieën, omdat ze het redeneervermogen van Gemini kunnen benutten zonder hun hele opslaginfrastructuur naar Google Cloud te migreren.
Geschikt voor multimodale AI-toepassingen (zoals video, spraak en documentbegrip).

Deze updates vereenvoudigen het data-ingestieproces aanzienlijk, zodat ontwikkelaars bestaande data rechtstreeks vanuit de cloud of het netwerk aan Gemini kunnen aanbieden zonder extra uploadstappen.

Wie profiteert het meest?

Productteams die documentgerichte features bouwen (samenvatten, Q&A over handleidingen, contractreview).
Media-/entertainment-apps die afbeeldingen, audio of video analyseren die al in de cloud zijn opgeslagen.
Enterprises met grote datalakes in GCS die willen dat het model naar canonieke kopieën verwijst in plaats van duplicatie.
Onderzoekers en engineers die willen prototypen met grotere, echte datasets zonder ingewikkelde storage-pipelines te bouwen.

Kortom: van prototype naar productie wordt eenvoudiger en goedkoper.

Hoe groot mag een bestand nu zijn dat je naar de Gemini API kunt uploaden?

Het belangrijkste getal is een vervijfvoudiging van de directe capaciteit, maar het echte verhaal zit in de flexibiliteit die dit biedt.

Hoe groot mag een bestand nu zijn via verschillende methoden?

Inline in een request (base64 of Part.from_bytes): tot 100 MB (50 MB voor sommige pdf-specifieke workflows). Gebruik dit wanneer je een eenvoudige single-request flow wilt en het bestand ≤100 MB is.
Externe HTTP-/ondertekende URL die door Gemini wordt opgehaald: tot 100 MB (Gemini haalt de URL op tijdens de verwerking). Gebruik dit om het opnieuw uploaden van content vanuit externe clouds te vermijden.
Files API (upload): tot 2 GB per bestand, projectopslag voor Files tot 20 GB, bestanden worden 48 uur bewaard. Gebruik dit voor grote bestanden die je wilt hergebruiken of die de 100 MB inline/externe limiet overschrijden.
GCS-objectregistratie: ondersteunt tot 2 GB per object en is bedoeld voor grote bestanden die al in Google Cloud staan; registratie maakt hergebruik zonder herhaalde uploads mogelijk. Eenmalige registratie kan toegang verlenen voor een beperkte periode.

(Welke keuze je precies maakt hangt af van de bestandsgrootte, frequentie van hergebruik en of het bestand al in cloudopslag staat.)

google-flie

De nieuwe 100MB-standaard

Met onmiddellijke ingang heeft de Gemini API de bestandsgrootte voor inline data verhoogd van 20 MB naar 100 MB.

Voorheen liepen ontwikkelaars die werkten met afbeeldingen met hoge resolutie, complexe pdf-contracten of audioclips van gemiddelde lengte vaak tegen de limiet van 20 MB aan. Dit dwong hen tot complexe workarounds, zoals het opdelen van data, het downsamplen van media of het beheren van een aparte uploadflow via de Files API, zelfs voor relatief kleine interacties.

Met de nieuwe 100 MB-limiet kun je nu aanzienlijk grotere payloads rechtstreeks in het API-verzoek meesturen (base64-gecodeerd). Dit is een cruciale verbetering voor:

Realtime-toepassingen: Een door de gebruiker geüploade video van 50 MB verwerken voor directe sentimentanalyse zonder te wachten op een asynchrone uploadtaak.
Snel prototypen: een complex dataset of een volledige boek-pdf in het contextvenster plaatsen om onmiddellijk een promptstrategie te testen.
Complexe multimodaliteit: Een combinatie van 4K-afbeeldingen en audiofragmenten met hoge kwaliteit in één beurt verzenden zonder je zorgen te maken over een beperkende cap.

Belangrijk om te weten: hoewel de inline limiet 100 MB is, blijft de capaciteit van de Gemini API om enorme datasets (terabytes aan data) te verwerken beschikbaar via de Files API en de nieuwe ondersteuning voor externe links, waarmee de bovengrens voor zware workloads in de praktijk wordt weggenomen.

Aanbevolen beslisflow

Als bestand ≤ 100 MB en je wilt single-request eenvoud: gebruik inline (Part.from_bytes of base64 meesturen). Goed voor snelle demo’s of serverless functies.
Als bestand ≤ 100 MB en al publiek of via een pre-signed URL gehost: geef de file_uri (HTTPS of ondertekende URL) door. Upload is niet nodig.
Als bestand > 100 MB (en ≤ 2 GB) of je verwacht hergebruik: Files API-upload of GCS-objectregistratie is aan te raden — dit vermindert herhaalde uploads en verbetert de latentie bij herhaalde generaties.

Hoe werkt de nieuwe ondersteuning voor externe bestandslinks?

De belangrijkste architecturale verandering is dat de Gemini API data nu zelf kan “ophalen”. Deze mogelijkheid betekent: rechtstreeks externe bestandslinks lezen, met ondersteuning voor ingebouwde databronnen.

De API kan nu data direct vanaf URL’s inlezen. Deze ondersteuning dekt twee verschillende scenario’s:

(1) Ondersteuning voor externe URL (Publiek / Ondertekende URL’s):

Je kunt nu een standaard HTTPS-URL die naar een bestand verwijst (zoals een pdf, afbeelding of video) direct in je generatierequest doorgeven.

Publieke URL’s: Ideaal voor het analyseren van content die al op het open web staat, zoals een nieuwsartikel-pdf of een publiek gehoste afbeelding.

Ondertekende URL’s: Dit is de brug voor enterprises. Als je data in een privé AWS S3-bucket of Azure Blob Storage staat, kun je een pre-signed URL genereren (een tijdelijke link die leestoegang verleent). Wanneer je deze URL aan Gemini doorgeeft, haalt de API de content tijdens de verwerking veilig op. Dit betekent dat je gevoelige documenten die op AWS zijn opgeslagen met Gemini kunt analyseren zonder ze permanent naar de servers van Google te verplaatsen.

Het respecteert Google Cloud IAM-rollen, wat betekent dat je toegang kunt beheren met de standaard “Storage Object Viewer”-machtigingen.

Voordelen: Geen tussenliggende bestanden nodig, verbetert beveiliging en performance, geschikt voor dataretrieval over cloudomgevingen heen.

(2) Directe koppeling met Google Cloud Storage (GCS):

Voor data die al binnen het Google-ecosysteem staat, is de integratie nog nauwer. Je kunt nu objectregistratie uitvoeren voor GCS-bestanden.

In plaats van te uploaden, “registreer” je eenvoudig de gs://-URI van het bestand.

Dit proces is vrijwel direct, omdat er geen echte datatransfer tussen je client en de API plaatsvindt.

Hoe gebruik je de nieuwe features? — Gebruiksvoorbeelden (Python SDK)

Hieronder staan drie praktische Python-voorbeelden (synchronisch) die de meest voorkomende patronen illustreren: (A) inline bytes (van een lokaal bestand), (B) externe HTTPS- of ondertekende URL, en (C) verwijzen naar een GCS-URI (geregistreerd object). Deze snippets gebruiken de officiële Google Gen AI Python SDK (google-genai). Pas modelnamen, authenticatie en omgevingsvariabelen aan je setup aan. Je kunt de API-sleutel van CometAPI gebruiken om toegang te krijgen tot de Gemini API, een AI-API-aggregatieplatform dat goedkopere API-prijzen biedt om ontwikkelaars te helpen.

Vereiste: pip install --upgrade google-genai en stel je credentials/omgevingsvariabelen in (voor Developer API API_KEY, voor Vertex AI stel GOOGLE_GENAI_USE_VERTEXAI, GOOGLE_CLOUD_PROJECT, GOOGLE_CLOUD_LOCATION in).

Voorbeeld A: Inline bytes (lokaal bestand → verzend tot 100 MB)

# Voorbeeld A: de bytes van een lokaal bestand inline verzenden (geschikt tot 100 MB)from google import genaifrom google.genai import types# Client maken (Developer API)client = genai.Client(api_key="YOUR_GEMINI_API_KEY")MODEL = "gemini-2.5-flash"  # kies een model; productiemodellen kunnen afwijkenfile_path = "large_document.pdf"  # lokaal bestand <= ~100 MBmime_type = "application/pdf"# Bytes lezen en een inline Part makenwith open(file_path, "rb") as f:    data = f.read()part = types.Part.from_bytes(data=data, mime_type=mime_type)# Het bestand inline verzenden met een tekstuele promptresponse = client.models.generate_content(    model=MODEL,    contents=[        "Vat het bijgevoegde document samen in één alinea.",        part,    ],)print(response.text)client.close()

Opmerkingen: dit gebruikt Part.from_bytes(...) om bestandsbytes in te sluiten. Inline payloads zijn nu toegestaan tot ~100 MB. Als je daar overheen gaat, gebruik dan een GCS- of Files API-aanpak.

Voorbeeld B: Externe HTTPS-/ondertekende URL (Gemini haalt de payload op)

# Voorbeeld B: verwijs naar een publieke HTTPS-URL of een ondertekende URL (Gemini haalt deze op)from google import genaifrom google.genai import typesclient = genai.Client(api_key="YOUR_API_KEY")MODEL = "gemini-2.5-flash"# Publieke of ondertekende URL naar een pdf/afbeelding/audio/etc.external_url = "https://example.com/reports/quarterly_report.pdf"# of een vooraf ondertekende S3/Azure-URL:# external_url = "https://s3.amazonaws.com/yourbucket/obj?X-Amz-..."part = types.Part.from_uri(file_uri=external_url, mime_type="application/pdf")response = client.models.generate_content(    model=MODEL,    contents=[        "Geef me de drie belangrijkste inzichten uit dit rapport.",        part,    ],)print(response.text)client.close()

Opmerkingen: Gemini haalt de external_url op tijdens het request. Gebruik ondertekende URL’s voor privé cloudopslagproviders (AWS/Azure). Externe fetches hebben praktische grootte-/formatlimieten (zie documentatie).

Voorbeeld C: Verwijs rechtstreeks naar een GCS-object (gs://)

# Voorbeeld C: verwijs naar een GCS-bestand (zorg dat de serviceaccount storage-toegang heeft)from google import genaifrom google.genai import types# Voor Vertex AI is het gebruikelijk om ADC (Application Default Credentials) te gebruikenclient = genai.Client(vertexai=True, project="your-project-id", location="us-central1")MODEL = "gemini-3-pro"  # voorbeeld model-idgcs_uri = "gs://my-bucket/path/to/manual.pdf"part = types.Part.from_uri(file_uri=gcs_uri, mime_type="application/pdf")response = client.models.generate_content(    model=MODEL,    contents=[        "Haal de sectietitels uit de bijgevoegde handleiding en zet ze op een rij.",        part,    ],)print(response.text)client.close()

Opmerkingen: GCS-toegang vereist de juiste IAM- en serviceaccountconfiguratie (object viewer-machtigingen, correcte authenticatie). Wanneer je GCS-objecten registreert of verwijst, zorg ervoor dat de runtime-omgeving (Vertex/ADC/serviceaccount) de benodigde permissies heeft.

Beperkingen en beveiligingsoverwegingen

Beperkingen qua grootte en contenttype

Externe fetch-grootte: het ophalen via externe URL’s is onderhevig aan de gedocumenteerde limieten (in de praktijk 100 MB per opgehaalde payload) en ondersteunde MIME-/contenttypen. Als je zeer grote assets (meerdere GB’s) moet aanbieden, gebruik dan de Files API of een andere verwerkingspipeline.

Files API vs inline vs externe URL: wanneer gebruik je wat

Inline (from_bytes) — het eenvoudigst voor losse, eenmalige bestanden waarbij je toepassing de bytes al heeft en de grootte ≤100 MB is. Goed voor experimenten en kleine services.
Externe URL/ondertekende URL — het beste wanneer het bestand elders staat (S3, Azure, publiek web); voorkomt het verplaatsen van bytes en verlaagt bandbreedte. Gebruik ondertekende URL’s voor privé-assets.
GCS/geregistreerde objecten — het beste wanneer je data al op Google Cloud staat en je een productiepatroon met stabiele referenties en IAM-controles wilt.
Files API — gebruik voor persistente of zeer grote bestanden die je over meerdere verzoeken wilt hergebruiken; let op per-bestand- en projectquota en beleid rondom retentie/vergankelijkheid.

Beveiliging en privacy

Ondertekende URL’s: genereer pre-signed URL’s met een beperkte levensduur en smalle permissies. Plaats geen langlevende secrets in requests.
IAM & OAuth: stel voor directe GCS-toegang serviceaccounts in volgens het principe van least privilege (objectViewer voor leestoegang). Volg de best practices van je organisatie voor sleutelorbitatie en logging.
Dataresidency & compliance: als je de API externe content laat ophalen, zorg dan dat dit in overeenstemming is met je datahandling- en compliancevereisten (bepaalde gereguleerde data mag niet naar een externe dienst worden verzonden, zelfs niet tijdelijk). De modelprovider kan metadata over requests in logs bewaren — houd daar rekening mee in je privacy-analyse.

Operationele kanttekeningen

Tijdelijke Files API-opslag: bestanden die naar de Files API zijn geüpload kunnen vergankelijk zijn (historisch 48 uur); gebruik voor langdurige opslag GCS of andere duurzame stores en verwijs er rechtstreeks naar.
Herhaald ophalen: als een bestand via een URL bij elk verzoek wordt verwezen en vaak wordt gebruikt, kun je herhaalde fetch-overhead oplopen; overweeg caching of het registreren van een GCS-kopie voor intensief hergebruik.

Wat dit betekent voor app-architectuur — praktische voorbeelden

Gebruiksscenario — kennisassistent met veel documenten

Als je een interne kennisassistent runt die producthandleidingen in GCS leest, registreer die GCS-objecten één keer (of verwijs met gs://-URI’s) en bevraag ze dynamisch. Zo voorkom je dat je dezelfde pdf’s steeds opnieuw uploadt en houd je je backend eenvoudiger. Gebruik Files API/GCS-registratie voor zeer grote handleidingen (>100 MB).

Gebruiksscenario — consumentenapp die foto’s verstuurt

Voor een mobiele app die afbeeldingen verstuurt voor een eenmalige bijschriftgeneratie: gebruik inline bytes voor kleine afbeeldingen (<100 MB). Dat houdt de UX eenvoudig en voorkomt een tweede uploadstap. Als gebruikers dezelfde afbeelding vaak hergebruiken of delen, sla hem op in GCS en geef een gs:// of ondertekende URL door.

Gebruiksscenario — audiotranscriptiepijplijnen

Korte spraaknotities (<100 MB / < ~1 minuut afhankelijk van codec) kun je inline of via een ondertekende URL doorgeven. Voor lange opnames: upload via de Files API en verwijs in volgende generatie-calls naar het bestand voor efficiënt hergebruik. Video-/audioworkflows hebben vaak extra best practices in de mediadocumentatie.

Conclusie

De update van Google’s Gemini API maakt het veel eenvoudiger om “bestaande” data naar generatieve AI-workflows te brengen: direct ophalen vanaf publieke of ondertekende URL’s en GCS-registratie halen een veelvoorkomende operationele frictie weg, en de sprong van 20 MB → 100 MB voor inline payloads geeft engineers meer flexibiliteit voor eenvoudige, single-request flows. Voor langlevende, zeer grote of vaak hergebruikte bestanden blijft de Files API (2 GB per bestand, standaard 48 uur opslag) de aangewezen route.

Om te beginnen: verken de Gemini API via CometAPI, bekijk Gemini 3 Pro en gemini 3 flash in de Playground en raadpleeg de API-gids voor gedetailleerde instructies. Zorg ervoor dat je bent ingelogd bij CometAPI en een API-sleutel hebt verkregen voordat je toegang aanvraagt. CometAPI biedt een prijs die veel lager is dan de officiële prijs om je integratie te ondersteunen.

Klaar om te starten?→ Gratis proef van Gemini 3 Pro !