Përdorimi i çelësave API të Gemini

Për të përdorur Gemini API, duhet të autentifikoni kërkesat tuaja. Mund të autentifikoni duke përdorur një çelës standard ose autorizues API.

Krijo ose shiko një Çelës API Gemini

Llojet e çelësave API: standard kundrejt autorizimit

Çelësat API ofrojnë qasje në Gemini API, por karakteristikat e tyre të sigurisë ndryshojnë. Gemini API po kalon nga çelësat standardë API në çelësat e autorizimit për të përmirësuar sigurinë:

• Çelësat standardë të API-t : Lidhni kërkesat me një projekt të Google Cloud për qëllime faturimi dhe kuotash. Çelësat standardë nuk identifikojnë një thirrës, gjë që kufizon detajet e lejeve dhe kontrollin e aksesit që ato mund të mbështesin.
• Çelësat e autorizimit (auth) : Të lidhur direkt me një llogari shërbimi Google Cloud. Kur përdorni një çelës autorizimi, kërkesat tuaja përpunohen sipas identitetit të asaj llogarie shërbimi të lidhur, duke mundësuar kontrollin e detajuar të aksesit. Çelësat e autorizimit janë të kufizuar në Generative Language API (Gemini API) si parazgjedhje dhe ofrojnë zbatim të shpejtë të çelësave të rrjedhur që ndalon shpejt përdorimin e çelësave të rrjedhur të zbuluar nga sistemet tona.

Për të siguruar përdorim të sigurt, Gemini API do të kalojë nga çelësat Standardë në çelësat Auth:

• Çelësat e parazgjedhur të autorizimit : Të gjithë çelësat e rinj API të krijuar në Google AI Studio krijohen automatikisht si çelësa autorizimi.
• Çelësat e pakufizuar u refuzuan : API-ja Gemini refuzon kërkesat nga çelësat standardë të pakufizuar . Çelësat standardë të API-t që kanë kufizime të qarta të aplikuara vazhdojnë të funksionojnë. Ky kufizim parandalon përdorimin e paautorizuar të çelësave që mund të ndahen publikisht ose të lidhen me shërbime të tjera.
• Në shtator 2026 : API Gemini do të refuzojë kërkesat nga çelësat standardë . Duhet të migroni te çelësat e autorizimit para kësaj date për të shmangur ndërprerjen e shërbimit. Sigurohuni që të migroni te çelësat e autorizimit para shtatorit 2026.

Menaxhimi i çelësave API në Google AI Studio

Mund t’i menaxhoni projektet dhe çelësat tuaj direkt në Google AI Studio .

Projektet e Google Cloud

Çdo çelës API Gemini është i lidhur me një projekt të Google Cloud . Projektet e Google Cloud menaxhojnë faturimin, bashkëpunëtorët dhe lejet. Google AI Studio ofron një ndërfaqe të lehtë për të aksesuar këto projekte.

• Projekti i parazgjedhur : Nëse jeni përdorues i ri, Google AI Studio krijon automatikisht një projekt të parazgjedhur të Google Cloud dhe një çelës API pasi të pranoni Kushtet e Shërbimit. Mund ta riemërtoni këtë projekt duke lundruar te pamja e Projekteve në panelin tuaj.
• Projektet ekzistuese : Nëse tashmë keni një llogari Google Cloud, AI Studio nuk krijon një projekt të paracaktuar. Në vend të kësaj, duhet të importoni projektet tuaja ekzistuese.

Importimi i projekteve

Si parazgjedhje, Google AI Studio nuk i shfaq të gjitha projektet tuaja në Google Cloud. Duhet të importoni projektet që dëshironi të përdorni:

1. Shkoni te Google AI Studio .
2. Hapni Panelin e Kontrollit nga paneli i majtë dhe zgjidhni Projektet .
3. Klikoni butonin Importo projekte .
4. Kërko dhe zgjidh projektin Google Cloud që dëshiron të importosh, pastaj kliko Importo .
5. Pasi të importohet, shkoni te faqja Çelësat API në panelin e kontrollit për të krijuar një çelës në atë projekt.

Zgjidhja e problemeve me lejet e krijimit të çelësave për krijimin e çelësave

Nëse butoni Krijo çelës API nuk është i disponueshëm dhe shfaq mesazhin: "Nuk keni leje për të krijuar një çelës në këtë projekt" , ju mungojnë lejet e kërkuara IAM.

Kërkoji administratorit të projektit ose organizatës tënde në Google Cloud që të të japë një rol që përmban lejet e mëposhtme (si p.sh. Redaktues Projekti):

• resourcemanager.projects.get : Lejon AI Studio të verifikojë projektin.
• apikeys.keys.create : Lejon gjenerimin e çelësave.
• serviceusage.services.enable : Siguron që API-i i Gjuhës Gjenerative është i aktivizuar.
• iam.serviceAccounts.create : E nevojshme për të krijuar llogarinë e shërbimit të lidhur.
• iam.serviceAccountApiKeyBindings.create : Lidh llogarinë e shërbimit me çelësin API.

Nëse nuk mund të merrni akses administratori, mund të krijoni një projekt të ri në Google Cloud që nuk është i lidhur me një organizatë për të gjeneruar çelësat tuaj.

Vendosja e mjedisit tuaj

Pasi të keni një çelës, konfiguroni mjedisin tuaj për ta përdorur atë në mënyrë të sigurt në aplikacionet tuaja.

Opsioni 1: Përdorni variablat e mjedisit (rekomandohet)

Cakto variablin e mjedisit GEMINI_API_KEY ose GOOGLE_API_KEY . Bibliotekat e klientëve të API-t Gemini i zbulojnë dhe i përdorin automatikisht këto variabla. Nëse të dyja janë të vendosura, GOOGLE_API_KEY ka përparësi.

Zgjidhni sistemin tuaj operativ për të vendosur variablin:

~/.bashrc

touch ~/.bashrc && open ~/.bashrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.bashrc