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

Për të përdorur Gemini API, duhet të vërtetosh kërkesat e tua. Mund të identifikohesh duke përdorur një çelës standard ose autorizimi të API-së.

Krijo ose shiko një çelës të Gemini API

Llojet e çelësave të API-së: standarde kundrejt autorizimit

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

  • Çelësat standardë të API-së: Lidh kërkesat me një projekt të Google Cloud për qëllime faturimi dhe kuotash. Çelësat standardë nuk identifikojnë një telefonues, gjë që kufizon granularitetin e lejeve dhe kontrollin e qasjes që mund të mbështesin.
  • Çelësat e autorizimit (auth): Të lidhur drejtpërdrejt me një llogari të shërbimit të Google Cloud. Kur përdor një çelës autorizimi, kërkesat e tua përpunohen nën identitetin e asaj llogarie shërbimi të lidhur, duke mundësuar kontrollin e qasjes me granularitet të imët. Çelësat e autorizimit janë të kufizuar për API-në e gjuhës gjeneruese (Gemini API) si parazgjedhje dhe ofrojnë zbatimin e çelësave të rrjedhur me veprim të shpejtë që ndalon me shpejtësi përdorimin e çelësave të rrjedhur të zbuluar nga sistemet tona.

Për të siguruar përdorimin e sigurt, Gemini API do të kalojë nga çelësat standardë te çelësat e vërtetimit:

  • Parazgjedhja e çelësave të vërtetimit: Duke filluar nga data 28 maj 2026, të gjithë çelësat e rinj të API-së të krijuar në Google AI Studio krijohen automatikisht si çelësa vërtetimi.
  • Çelësat e pakufizuar u refuzuan: Gemini API refuzon kërkesat nga çelësat standardë të pakufizuar. Çelësat standardë të API-së që kanë kufizime të qarta të zbatuara 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.

Menaxhimi i çelësave të API-së në Google AI Studio

Mund t'i menaxhosh projektet dhe çelësat e tu drejtpërdrejt në Google AI Studio.

Projektet e Google Cloud

Çdo çelës i Gemini API ë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'u qasur në këto projekte.

  • Projekti i parazgjedhur: Nëse je një përdorues i ri, Google AI Studio krijon automatikisht një projekt të parazgjedhur të Google Cloud dhe një çelës API pasi pranon "Kushtet e shërbimit". Mund ta riemërtosh këtë projekt duke naviguar te pamja e Projekteve në panelin tënd.
  • Projektet ekzistuese: Nëse ke tashmë një llogari të Google Cloud, AI Studio nuk krijon një projekt të parazgjedhur. Në vend të kësaj, duhet të importosh projektet e tua ekzistuese.

Po importohen projektet

Si parazgjedhje, Google AI Studio nuk shfaq të gjitha projektet e tua të Google Cloud. Duhet të importosh projektet që dëshiron të përdorësh:

  1. Shko te Google AI Studio.
  2. Hap Panelin nga paneli majtas dhe zgjidh Projektet.
  3. Kliko butonin Importo projekte.
  4. Kërko dhe zgjidh projektin e Google Cloud që dëshiron të importosh dhe më pas kliko Importo.
  5. Pasi të importohet, navigo te faqja Çelësat e API-së në panel për të krijuar një çelës në atë projekt.

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

Nëse butoni Krijo çelësin e API-së nuk ofrohet dhe shfaq mesazhin: "Nuk ke leje për të krijuar një çelës në këtë projekt", të mungojnë lejet e kërkuara të IAM-së.

Kërkoji administratorit të projektit ose të organizatës së Google Cloud që të të japë një rol që përfshin lejet e mëposhtme (si p.sh. "Modifikues i projektit"):

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

Nëse nuk mund të marrësh qasje administrative, mund të krijosh një projekt të ri të Google Cloud që nuk është i lidhur me një organizatë për të gjeneruar çelësat e tu.

Krijimi i çelësave në Google Cloud Console

Google AI Studio shfaq vetëm çelësat që janë të pakufizuar ose të kufizuar për Gemini API. Nëse nuk mund të përdorësh AI Studio ose dëshiron të menaxhosh të gjithë çelësat e API-së në një vend të vetëm, ndiq dokumentacionin e Cloud për krijimin e një çelësi të API-së. Krijimi i një çelësi të Gemini API kërkon lidhjen e tij me një llogari shërbimi.

Konfigurimi i mjedisit tënd

Pasi të kesh një çelës, konfiguro mjedisin tënd për ta përdorur atë në mënyrë të sigurt në aplikacionet e tua.

Opsioni 1: Përdor ndryshoret e mjedisit (rekomandohet)

Cakto ndryshoren e mjedisit GEMINI_API_KEY ose GOOGLE_API_KEY. Bibliotekat kliente të Gemini API i zbulojnë dhe i përdorin automatikisht këto variabla. Nëse të dyja janë caktuar, GOOGLE_API_KEY ka përparësi.

Zgjidh sistemin tënd operativ për të caktuar ndryshoren:

Linux/macOS - Bash

Verifiko nëse ke një skedar konfigurimi bash:

~/.bashrc

Nëse jo, krijo një të tillë dhe hape atë:

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

Shto komandën e eksportimit në fund të skedarit:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Ruaj skedarin dhe më pas zbato ndryshimet:

source ~/.bashrc

macOS - Zsh

Verifiko nëse ke një skedar konfigurimi zsh:

~/.zshrc

Nëse jo, krijo një të tillë dhe hape atë:

touch ~/.zshrc && open ~/.zshrc

Shto komandën e eksportimit:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Ruaj skedarin dhe më pas zbato ndryshimet:

source ~/.zshrc

Windows

  1. Kërko për "Environment Variables" në shiritin e kërkimit të Windows.
  2. Kliko Variablat e mjedisit në dialogun e "Karakteristikave të sistemit".
  3. Te Variablat e përdoruesit ose Variablat e sistemit, kliko I ri....
  4. Cakto emrin e ndryshores në GEMINI_API_KEY dhe vlerën në çelësin tënd të API-së.
  5. Kliko Në rregull për ta ruajtur. Hap një seancë të re të terminalit për të ngarkuar ndryshoren.

Opsioni 2: Jep çelësin e API-së në mënyrë të qartë në kod

Mund ta kalosh çelësin e API-së në mënyrë të qartë kur inicializon klientin. Bëje këtë vetëm nëse nuk mund të përdorësh variablat e mjedisit.

Python

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain how AI works in a few words"
)
print(interaction.output_text)

JavaScript

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.8-flash",
    input: "Explain how AI works in a few words",
  });
  console.log(interaction.output_text);
}

main();

Java

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = Client.builder().apiKey("YOUR_API_KEY").build();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(InteractionsInput.of("Explain how AI works in a few sentences."))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

Go

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, &genai.ClientConfig{
        APIKey: "YOUR_API_KEY",
    })
    if err != nil {
        log.Fatal(err)
    }

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
            Model: interactions.Model("gemini-3.8-flash"),
            Input: interactions.NewInteractionsInput("Explain how AI works in a few sentences."),
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}

QETËSI

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -X POST \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Explain how AI works in a few words"
  }'

Siguria dhe menaxhimi i sekreteve

Trajtoje çelësin e Gemini API si një fjalëkalim. Nëse komprometohet, të tjerët mund të përdorin kuotën e projektit tënd, të shkaktojnë tarifa të papritura faturimi dhe të qasen te burimet private.

Rregullat kritike të sigurisë

  • Mbaji çelësat konfidencialë: Mos i kontrollo kurrë çelësat API në sistemet e kontrollit të burimit si Git.
  • Mos i ekspozo asnjëherë çelësat në anën e klientit në prodhim: Mos i kodosh çelësat e API-së drejtpërdrejt në aplikacionet e uebit ose për celular. Çelësat e përpiluar në kodin e anës së klientit mund të nxirren nga përdoruesit. Për të siguruar aplikacionet në anën e klientit, ekzekuto një server proxy të sistemit fundor për të bërë thirrjet aktuale të API-së.

Praktikat më të mira për menaxhimin e sekreteve

  • Ndryshoret e mjedisit: Lexo çelësat nga ndryshoret e mjedisit në vend të skedarëve të konfigurimit.
  • Menaxheri i sekreteve: Për prodhim, ruaj çelësat e tu në një dyqan të sigurt sekret, si p.sh. Google Cloud Secret Manager.
  • Sinjalizimet e faturimit: Konfiguro sinjalizimet e faturimit në Google Cloud Console për të të njoftuar nëse përdorimi ose kostot rriten në mënyrë të papritur.

Lista e kontrollit për përgjigjen ndaj rrjedhjes

Nëse dyshon se çelësi yt API është rrjedhur:

  1. Gjenero një çelës të ri: Krijo një çelës zëvendësues në Google AI Studio ose në Cloud Console.
  2. Përditëso aplikacionin tënd: Vendos kodin tënd duke përdorur çelësin e ri.
  3. Çaktivizo ose fshi çelësin e komprometuar: Çaktivizo çelësin e rrjedhur në Cloud Console pasi të verifikohet çelësi i ri. Mos e fshi çelësin e vjetër derisa çelësi i ri të jetë plotësisht aktiv për të shmangur periudhën joaktive të aplikacionit.
  4. Përdorimi i auditimit: Kontrollo regjistrat e faturimit dhe përdorimin e API-së në konsolën e Google Cloud për të identifikuar aktivitetin e paautorizuar.

Po kufizojmë dhe po sigurojmë çelësat e tu

Shtimi i kufizimeve në çelësat e tu të API-së minimizon dëmin e mundshëm nëse një çelës komprometohet.

Zbato kufizimet e origjinës së kërkesës

Kufizimet e origjinës kufizojnë se cilat adresa IP, uebsajte ose aplikacione mund të përdorin çelësin tënd.

  1. Shko te faqja e kredencialeve të Google Cloud Console.
  2. Zgjidh projektin tënd dhe kliko emrin e çelësit API që dëshiron të kufizosh.
  3. Te Kufizimet e aplikacionit, zgjidh Adresat IP (ose llojin e duhur të kufizimit për mjedisin tënd).
  4. Specifiko adresat ose diapazonet e lejuara të IP-së dhe më pas kliko Ruaj.

Sigurimi i çelësave standardë të API-së pa kufizime

Për të vazhduar të përdorësh API-në e Gemini, duhet të sigurosh çdo çelës të parestriktuar.

Metoda A: Kufizo çelësin vetëm për Gemini API (AI Studio)

Nëse e përdor çelësin vetëm për Gemini API, siguroje atë drejtpërdrejt në AI Studio:

  1. Në faqen Çelësat e API-së në Google AI Studio, gjej çelësat e shënuar me etiketën Pa kufizime.
  2. Qëndro pezull mbi etiketën dhe kliko Shto kufizime në dialog.
  3. Zgjidh Kufizo vetëm në Gemini API.
  4. Kliko Kufizo çelësin për të konfirmuar.

Metoda B: Kufizo çelësin për shërbimet e tjera (Google Cloud Console)

Nëse çelësi ndahet me API-të e tjera të Google (nuk rekomandohet), kufizoje atë në konsolën e Cloud. Shënim. Kërkesat e Gemini API që përdorin këtë çelës do të dështojnë pasi të zbatohen këto kufizime.

  1. Vizito faqen e kredencialeve të Google Cloud Console.
  2. Zgjidh projektin dhe çelësin API.
  3. Te Kufizimet e API-së, përdor menynë me lëshim poshtë Zgjidh kufizimet e API-së për të zgjedhur API-të te të cilat dëshiron që të ketë qasje ky çelës. Mos zgjidh Generative Language API.
  4. Kliko Ruaj. Krijo një çelës të veçantë të kufizuar në AI Studio për të vazhduar të përdorësh Gemini API.

Tastet e bllokuara joaktive

Duke filluar nga data 7 maj 2026, Gemini API bllokon çelësat e API-së pa kufizime që kanë qenë joaktivë për një periudhë të gjatë. Këta çelësa shfaqin një etiketë Të bllokuar në AI Studio. Duhet të gjenerosh një çelës të ri ose të përdorësh një çelës ekzistues të kufizuar për të vazhduar.

Migro te një çelës vërtetimi

Ndiq këta hapa për të krijuar një çelës të ri API për vërtetimin dhe për të përditësuar aplikacionet e tua:

  1. Shko te faqja e çelësave të API-së të AI Studio.
  2. Kontrollo kolonën Lloji i çelësit për të identifikuar çdo çelës të listuar si Standard.
  3. Kliko Krijo çelësin e API-së për të gjeneruar një çelës të ri. Të gjithë çelësat e rinj të krijuar në AI Studio krijohen automatikisht si çelësa vërtetimi.
  4. Kopjo çelësin e ri të API-së të vërtetimit.
  5. Përditëso kodin e aplikacionit, variablat e mjedisit dhe çdo konfigurim të shpërndarjes për të përdorur çelësin e ri të API-së së vërtetimit.
  6. Testo aplikacionin tënd për të konfirmuar që funksionon siç duhet me çelësin e ri.
  7. Pasi të verifikohet, fshi ose revoko çelësin e vjetër të trafikut për të parandaluar keqpërdorimin.

Kufizimet

Google AI Studio vendos kufizimet e mëposhtme për menaxhimin e projekteve dhe çelësave:

  • Mund të krijosh maksimumi 10 projekte në të njëjtën kohë nga faqja e Projekteve të Google AI Studio.
  • Faqet Çelësat API dhe Projektet shfaqin maksimumi 100 çelësa dhe 50 projekte.
  • Shfaqen vetëm çelësat API që janë të pakufizuar ose të kufizuar posaçërisht për API-n e gjuhës gjeneruese (API-n e Gemini).

Për menaxhim të avancuar të projekteve ose për të modifikuar çelësat me kufizime të tjera, përdor faqen e kredencialeve të Google Cloud Console.