Cheia API Gemini: cum o obtii gratis, limite si costuri

Cheia API Gemini (Gemini API key) se obtine gratuit din Google AI Studio: te autentifici cu un cont Google, deschizi pagina de chei API, apesi pe Create API key si in cateva minute poti face primul apel. Nivelul gratuit nu costa nimic, dar continutul trimis este folosit pentru imbunatatirea produselor Google. Cu facturarea activa platesti pe consum, de exemplu 0,75 $ pe milion de tokeni de input pentru Gemini 3.8 Flash.

In acest ghid iti arat pas cu pas cum creezi cheia API Gemini, ce primesti de fapt pe planul gratuit, cat platesti cand treci pe plata, ce limite exista si cum o protejezi.

Ultimul punct conteaza acum mai mult ca de obicei. Saptamana aceasta, o bresa in OpenCode Console a expus chei OpenAI, Anthropic si Google salvate de utilizatori, iar cei care le lasasera fara limite au gasit pe factura consum pe care nu il facusera ei.

Ce este cheia API Gemini si la ce foloseste

Cheia API Gemini este sirul de caractere care identifica proiectul tau atunci cand un program apeleaza modelele Google.

Fara cheie folosesti Gemini doar din aplicatie sau din browser. Cu cheie il poti lega de un script, de un chatbot pe site, de o automatizare in n8n sau de un agent de programare.

Doua lucruri de stiut de la inceput:

• Cheia este legata de un proiect Google Cloud, chiar daca o creezi din AI Studio. Limitele de utilizare se aplica pe proiect, nu pe fiecare cheie.
• Cine are cheia cheltuie in numele tau. Daca ajunge intr-un repository public sau intr-un serviciu compromis, oricine poate face cereri pe care le platesti tu.

Daca lucrezi si cu Anthropic, pasii sunt asemanatori cu cei din ghidul pentru Claude API key: se schimba consola, preturile si numele modelelor.

Cum obtii cheia API Gemini in 5 pasi

1. Deschide Google AI Studio si autentifica-te cu contul Google. Mergi in sectiunea de chei API (API keys).
2. Accepta Termenii de utilizare. Daca esti utilizator nou, AI Studio creeaza automat un proiect Google Cloud si o cheie implicita.
3. Importa un proiect existent daca ai deja cont Google Cloud: Dashboard, Projects, Import projects, alegi proiectul si apesi Import.
4. Apasa pe Create API key si copiaza cheia. Din 28 mai 2026, cheile noi create in AI Studio sunt implicit chei de autorizare.
5. Salveaz-o intr-o variabila de mediu, nu in cod. Mai jos gasesti comenzile pentru macOS, Linux si Windows.

Daca butonul Create API key nu apare

Se intampla aproape mereu pe conturile de firma. Proiectul cere permisiunea IAM apikeys.keys.create, inclusa de exemplu in rolul Project Editor. Cere administratorului Google Cloud sa iti dea rolul potrivit sau sa creeze el cheia pentru tine.

Cheia API Gemini este gratuita? Nivel gratuit vs nivel platit

Da, cheia API Gemini este gratuita si o poti folosi fara card pe nivelul gratuit. Diferenta reala fata de nivelul platit nu este doar pretul:

• Nivel gratuit: acces la o parte din modele, tokeni de input si output fara cost, limite de frecventa mici. Continutul trimis este folosit pentru imbunatatirea produselor Google.
• Nivel platit: limite mai mari, context caching, Batch API cu 50% reducere, acces la modelele avansate. Continutul nu este folosit pentru imbunatatirea produselor.

Printre modelele disponibile gratuit sunt Gemini 3.8 Flash, 3.6 Flash, 3.5 Flash-Lite, 3.1 Flash-Lite si cateva variante vocale, ca Gemini 3.8 Live si modelele TTS. Gemini 3.1 Pro in preview si modelele de imagine Nano Banana nu sunt pe nivelul gratuit.

Ce inseamna asta pentru un SRL sau un PFA

Pentru teste personale, nivelul gratuit e perfect. Pentru o firma din Romania lucrurile se schimba: daca prin prompt trec emailuri de la clienti, oferte, CNP-uri sau alte date personale, nu are sens sa folosesti un plan in care acel continut ajuta la imbunatatirea produselor altcuiva. Raspunderea fata de GDPR si fata de ANSPDCP ramane a ta, nu a furnizorului.

Asta este regula pe care o urmez cand leg Gemini de un CRM sau de un chatbot: prototip pe nivelul gratuit cu date fictive, productie doar cu facturarea activa.

Cat costa cheia API Gemini pe nivelul platit

Cheia API Gemini nu costa nimic: platesti tokenii consumati, in dolari, pe factura Google Cloud.

Acestea sunt preturile Standard pe milion de tokeni publicate de Google, valabile pana la 31 decembrie 2026. De la 1 ianuarie 2027 mai multe modele se scumpesc de doua ori, asa ca tine cont de asta daca faci o oferta pentru un client.

• Gemini 3.8 Flash: 0,75 $ input, 3,75 $ output, input din cache 0,075 $.
• Gemini 3.6 Flash: 0,75 $ input, 3,75 $ output.
• Gemini 3.5 Flash-Lite: 0,30 $ input, 2,50 $ output.
• Gemini 3.1 Flash-Lite: 0,25 $ input (0,50 $ pentru audio), 1,50 $ output.
• Gemini 3.1 Pro (preview): 2 $ input si 12 $ output pana la 200.000 de tokeni de prompt, apoi 4 $ si 18 $.

Doua costuri care scapa des din calcul:

• Batch API: jumatate de pret cand nu ai nevoie de raspuns imediat, de exemplu pentru clasificarea a mii de tichete peste noapte.
• Grounding cu Google Search: 5.000 de cereri gratuite pe luna, comune pentru modelele Gemini 3 si mai noi, apoi 14 $ la 1.000. O singura cerere poate genera mai multe cautari si fiecare se taxeaza.

Ca sa alegi modelul potrivit, am comparat cele mai folosite doua in Gemini 3.8 Flash vs 3.1 Pro. Pentru prompturi lungi, factura scade mult cu prompt caching.

Limitele cheii API Gemini: RPM, TPM, RPD si tier-uri

Limitele se masoara pe trei axe: cereri pe minut (RPM), tokeni de input pe minut (TPM) si cereri pe zi (RPD). E suficient sa depasesti una ca sa primesti eroare, chiar daca la celelalte esti sub prag.

• Limitele sunt pe proiect: zece chei in acelasi proiect nu iti dau de zece ori cota.
• Contorul zilnic se reseteaza la miezul noptii, ora Pacificului, adica la ora 10 dimineata in Romania in cea mai mare parte a anului.
• Valorile actuale ale proiectului tau le vezi in pagina Rate limit din AI Studio.

Nivelurile platite

Cand legi un cont de facturare treci in Tier 1, iar de acolo Google te urca automat:

• Tier 1: cont de facturare activ, plafon de 250 $ si maximum 10 $ la fiecare 10 minute.
• Tier 2: minimum 100 $ platiti si 3 zile de la prima plata, plafon de 2.000 $ si 50 $ la 10 minute.
• Tier 3: minimum 1.000 $ platiti si 30 de zile de la prima plata, plafon de la 20.000 $ in sus si 200 $ la 10 minute.

Plafonul pe fereastra de 10 minute este si o protectie: daca cineva iti fura cheia pe un proiect in Tier 1, paguba are o limita. Cand il atingi primesti eroarea 429 RESOURCE_EXHAUSTED.

Primul apel: variabila de mediu si cod

Google citeste cheia din GEMINI_API_KEY sau din GOOGLE_API_KEY. Daca le setezi pe amandoua, castiga GOOGLE_API_KEY: o sursa clasica de erori cand ai mai multe proiecte pe acelasi calculator.

Pe macOS cu zsh adaugi linia in fisierul ~/.zshrc (pe Linux cu bash folosesti ~/.bashrc):

export GEMINI_API_KEY=cheia_ta
source ~/.zshrc

Pe Windows cauti "Environment Variables", adaugi o variabila de utilizator numita GEMINI_API_KEY si deschizi un terminal nou.

Primul apel cu curl foloseste header-ul x-goog-api-key:

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -X POST \
  -d '{"model": "gemini-3.8-flash", "input": "Explica in doua randuri la ce foloseste un API"}'

In Python, cu biblioteca oficiala si variabila de mediu setata, nici nu mai trebuie sa trimiti cheia:

from google import genai

client = genai.Client()
interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explica in doua randuri ce este un API"
)
print(interaction.output_text)

Cum protejezi cheia API Gemini

In 2026 Google a strans regulile: API-ul Gemini refuza cheile standard fara restrictii, iar din 7 mai blocheaza cheile fara restrictii ramase mult timp inactive. Regulile pe care le aplic la fiecare proiect:

1. Restrictioneaza cheia doar la API-ul Gemini. In AI Studio gasesti cheia marcata ca nerestrictionata, apesi pe adaugarea de restrictii, alegi limitarea doar la Gemini API si confirmi.
2. Niciodata in codul din browser sau din aplicatia mobila. O cheie pusa acolo este publica. Apelurile trec printr-un server al tau.
3. Niciodata in Git. Foloseste un fisier .env exclus din repository si, in productie, un seif de secrete precum Secret Manager.
4. O cheie separata pentru fiecare instrument. Daca un serviciu tert este compromis, cum s-a intamplat cu OpenCode Console, revoci doar cheia aceea. Am scris despre OpenCode si in comparatia Claude Code vs OpenCode vs Codex.
5. Seteaza alertele de buget in consola Google Cloud. O alerta te anunta, nu opreste cheltuiala: plafonul real este cel al tier-ului.

Daca cheia a fost compromisa

Procedura recomandata de Google: creezi o cheie API Gemini noua, actualizezi codul si variabilele de mediu, dezactivezi cheia compromisa din consola Cloud fara sa o stergi imediat si verifici jurnalele de utilizare si de facturare.

La o rotatie planificata ordinea e aceeasi: stergi cheia veche doar dupa ce ai verificat ca aplicatia merge cu cea noua.

Erori frecvente cu cheia API Gemini

• 429 RESOURCE_EXHAUSTED: ai depasit o limita de frecventa sau de cheltuiala. Asteapta si reincearca, redu contextul si lungimea raspunsurilor sau cere o crestere a limitei.
• Cheie marcata ca blocata: era fara restrictii si inactiva de mult. Creeaza una noua si restrictioneaz-o la Gemini API.
• Cereri refuzate cu o cheie creata in Google Cloud: probabil este o cheie standard fara restrictii sau Generative Language API lipseste din lista de API-uri permise.
• Model indisponibil: apelezi un model care nu este pe nivelul gratuit, de exemplu Gemini 3.1 Pro in preview.

Daca te intereseaza modelul de top al Google, detaliile despre pret si disponibilitate sunt in articolul despre Gemini 4 Argon.

Citeste si

• Claude API key: cum o obtii, cat costa si primul apel
• Gemini 3.8 Flash vs 3.1 Pro: care folosesti si cat costa
• Prompt caching Claude si OpenAI: cum reduci costurile API

Concluzie

Sa obtii cheia API Gemini este partea usoara: cinci minute in AI Studio.

Diferenta o face restul: sa alegi nivelul potrivit pentru datele pe care le procesezi, sa restrictionezi cheia la Gemini API, sa o tii pe server si sa stii care este plafonul de cheltuieli al proiectului inainte sa il afle altcineva.

Daca vrei sa conectezi Gemini la site, la CRM sau la un flux de lucru fara sa expui chei si date ale clientilor, vezi cum lucrez pe automatizari AI pentru firme si pe agenti AI, sau scrie-mi si discutam.