Kjo faqe është përkthyer nga Cloud Translation API.

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

Për të përdorur Gemini API, ju nevojitet një çelës API. Kjo faqe përshkruan se si të krijoni dhe menaxhoni çelësat tuaj në Google AI Studio, si dhe si të konfiguroni mjedisin tuaj për t'i përdorur ato në kodin tuaj.

Çelësat API

Një çelës API është një varg i enkriptuar që mund ta përdorni kur thirrni API-të e Google Cloud. Mund të krijoni dhe menaxhoni të gjithë çelësat tuaj të API-t Gemini nga faqja e çelësave të API- t të Google AI Studio .

Pasi të keni një çelës API, keni opsionet e mëposhtme për t'u lidhur me Gemini API:

Vendosja e çelësit API si një ndryshore mjedisi
Dhënia e çelësit tuaj API në mënyrë të qartë

Për testimin fillestar, mund të kodoni një çelës API, por kjo duhet të jetë vetëm e përkohshme pasi nuk është e sigurt. Mund të gjeni shembuj për kodimin e çelësit API në seksionin " Dhënia e çelësit API në mënyrë të qartë" .

Projektet e Google Cloud

Projektet e Google Cloud janë thelbësore për përdorimin e shërbimeve të Google Cloud (siç është Gemini API), menaxhimin e faturimit dhe kontrollin e bashkëpunëtorëve dhe lejeve. Google AI Studio ofron një ndërfaqe të lehtë për projektet tuaja të Google Cloud.

Nëse nuk keni krijuar ende ndonjë projekt, duhet të krijoni një projekt të ri ose të importoni një nga Google Cloud në Google AI Studio. Faqja e Projekteve në Google AI Studio do të shfaqë të gjithë çelësat që kanë leje të mjaftueshme për të përdorur Gemini API. Referojuni seksionit të importimit të projekteve për udhëzime.

Projekti i parazgjedhur

Për përdoruesit e rinj, pas pranimit të Kushteve të Shërbimit, Google AI Studio krijon një Projekt dhe Çelës API të parazgjedhur të Google Cloud, për lehtësi përdorimi. Mund ta riemërtoni këtë projekt në Google AI Studio duke lundruar te pamja e Projekteve në Panelin e Kontrollit , duke klikuar butonin e cilësimeve me 3 pika pranë një projekti dhe duke zgjedhur Riemërto projektin . Përdoruesit ekzistues ose përdoruesit që tashmë kanë Llogari Google Cloud nuk do të kenë të krijuar një projekt të parazgjedhur.

Importo projekte

Çdo çelës Gemini API është i lidhur me një projekt të Google Cloud. Si parazgjedhje, Google AI Studio nuk i shfaq të gjitha Projektet tuaja në Cloud. Ju duhet të importoni projektet që dëshironi duke kërkuar emrin ose ID-në e projektit në dialogun Importo Projektet . Për të parë një listë të plotë të projekteve në të cilat keni qasje, vizitoni Cloud Console.

Nëse nuk keni importuar ende ndonjë projekt, ndiqni këto hapa për të importuar një projekt në Google Cloud dhe për të krijuar një çelës:

Shkoni te Google AI Studio .
Hapni Panelin e Kontrollit nga paneli anësor i majtë.
Zgjidhni Projektet .
Zgjidhni butonin Importo projekte në faqen Projekte .
Kërko dhe zgjidh projektin Google Cloud që dëshiron të importosh dhe zgjidh butonin Importo .

Pasi të importohet një projekt, shkoni te faqja Çelësat API nga menyja Dashboard dhe krijoni një çelës API në projektin që sapo importuat.

Kufizime

Më poshtë janë kufizimet e menaxhimit të çelësave API dhe projekteve të Google Cloud në Google AI Studio.

Mund të krijoni maksimumi 10 projekte në të njëjtën kohë nga faqja e Projekteve të Google AI Studio.
Ju mund të emërtoni dhe riemërtoni projekte dhe çelësa.
Çelësat API dhe faqet e Projekteve shfaqin një maksimum prej 100 çelësash dhe 50 projektesh.
Shfaqen vetëm çelësat API që nuk kanë kufizime ose janë të kufizuar në API-n e Gjuhës Gjenerative.

Për akses shtesë në menaxhim të projekteve tuaja, vizitoni Google Cloud Console.

Vendosja e çelësit API si një ndryshore mjedisi

Nëse caktoni variablin e mjedisit GEMINI_API_KEY ose GOOGLE_API_KEY , çelësi API do të merret automatikisht nga klienti kur përdor një nga libraritë e API-t Gemini . Rekomandohet që të caktoni vetëm një nga këto variabla, por nëse të dyja janë të caktuara, GOOGLE_API_KEY ka përparësi.

Nëse po përdorni REST API ose JavaScript në shfletues, do t'ju duhet të jepni çelësin API në mënyrë të qartë.

Ja se si mund ta caktoni çelësin tuaj API lokalisht si variablin e mjedisit GEMINI_API_KEY me sisteme të ndryshme operative.

Linux/macOS - Bash

Bash është një konfigurim i zakonshëm i terminalit Linux dhe macOS. Mund të kontrolloni nëse keni një skedar konfigurimi për të duke ekzekutuar komandën e mëposhtme:

~/.bashrc

Nëse përgjigjja është "Nuk ka skedar ose direktori të tillë", do t'ju duhet ta krijoni këtë skedar dhe ta hapni duke ekzekutuar komandat e mëposhtme ose duke përdorur zsh :

touch ~/.bashrc
open ~/.bashrc

Tjetra, duhet të vendosni çelësin tuaj API duke shtuar komandën e mëposhtme të eksportit:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Pasi ta ruani skedarin, aplikoni ndryshimet duke ekzekutuar komandën:

source ~/.bashrc

macOS - Zsh

Zsh është një konfigurim i zakonshëm i terminalit Linux dhe macOS. Mund të kontrolloni nëse keni një skedar konfigurimi për të duke ekzekutuar komandën e mëposhtme:

~/.zshrc

Nëse përgjigjja është "Nuk ka skedar ose direktori të tillë", do t'ju duhet të krijoni këtë skedar dhe ta hapni duke ekzekutuar komandat e mëposhtme ose duke përdorur bash :

touch ~/.zshrc
open ~/.zshrc

Tjetra, duhet të vendosni çelësin tuaj API duke shtuar komandën e mëposhtme të eksportit:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Pasi ta ruani skedarin, aplikoni ndryshimet duke ekzekutuar komandën:

source ~/.zshrc

Windows

Kërko për "Variablat e Mjedisit" në shiritin e kërkimit.
Zgjidhni të modifikoni Cilësimet e Sistemit . Mund t'ju duhet të konfirmoni që dëshironi ta bëni këtë.
Në dialogun e cilësimeve të sistemit, klikoni butonin e etiketuar Variablat e Mjedisit .
Nën Variablat e përdoruesit (për përdoruesin aktual) ose Variablat e sistemit (vlen për të gjithë përdoruesit që përdorin makinën), klikoni I ri...
Specifikoni emrin e variablit si GEMINI_API_KEY . Specifikoni Çelësin tuaj Gemini API si vlerën e variablit.
Klikoni OK për të aplikuar ndryshimet.
Hapni një sesion të ri terminali (cmd ose Powershell) për të marrë variablin e ri.

Dhënia e çelësit API në mënyrë të qartë

Në disa raste, mund të dëshironi të jepni në mënyrë të qartë një çelës API. Për shembull:

Po kryeni një thirrje të thjeshtë API dhe preferoni ta kodoni fort çelësin API.
Ju dëshironi kontroll të qartë pa pasur nevojë të mbështeteni në zbulimin automatik të variablave të mjedisit nga libraritë e API-t Gemini.
Po përdorni një mjedis ku variablat e mjedisit nuk mbështeten (p.sh. web) ose po bëni thirrje REST.

Më poshtë janë shembuj se si mund të jepni një çelës API në mënyrë të qartë:

Python

from google import genai

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

response = client.models.generate_content(
    model="gemini-2.5-flash", contents="Explain how AI works in a few words"
)
print(response.text)

JavaScript

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

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

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.5-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

Shko

package main

import (
    "context"
    "fmt"
    "log"
    "google.golang.org/genai"
)

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

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-2.5-flash",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}

Java

package com.example;

import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    Client client = Client.builder().apiKey("YOUR_API_KEY").build();

    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-2.5-flash",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.text());
  }
}

PUSHTIM

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Mbajeni çelësin tuaj API të sigurt

Trajtojeni çelësin tuaj Gemini API si një fjalëkalim. Nëse kompromentohet, të tjerët mund të përdorin kuotën e projektit tuaj, të shkaktojnë tarifa (nëse faturimi është i aktivizuar) dhe të kenë qasje në të dhënat tuaja private, siç janë skedarët.

Rregullat kritike të sigurisë

Mos i vendosni kurrë çelësat API në kontrollin e burimit. Mos e kontrolloni çelësin tuaj API në sistemet e kontrollit të versioneve si Git.
Mos i ekspozoni kurrë çelësat API në anën e klientit. Mos e përdorni çelësin tuaj API direkt në aplikacionet web ose celularë në prodhim. Çelësat në kodin e anës së klientit (duke përfshirë bibliotekat tona JavaScript/TypeScript dhe thirrjet REST) mund të nxirren.

Praktikat më të mira

Përdorni thirrje nga ana e serverit me çelësa API. Mënyra më e sigurt për të përdorur çelësin tuaj API është të thirrni API-n Gemini nga një aplikacion nga ana e serverit ku çelësi mund të mbahet konfidencial.
Përdorni tokena kalimtarë për akses nga ana e klientit (vetëm Live API): Për akses të drejtpërdrejtë nga ana e klientit në Live API, mund të përdorni tokena kalimtarë. Ato vijnë me rreziqe më të ulëta sigurie dhe mund të jenë të përshtatshme për përdorim në prodhim. Rishikoni udhëzuesin e tokenave kalimtarë për më shumë informacion.
Konsideroni shtimin e kufizimeve në çelësin tuaj: Mund të kufizoni lejet e një çelësi duke shtuar kufizime për çelësin API . Kjo minimizon dëmin e mundshëm nëse çelësi rrjedh ndonjëherë.

Për disa praktika më të mira të përgjithshme, mund të rishikoni edhe këtë artikull mbështetës .

Çelësat API

Pasi të keni një çelës API, keni opsionet e mëposhtme për t'u lidhur me Gemini API:

Vendosja e çelësit API si një ndryshore mjedisi
Dhënia e çelësit tuaj API në mënyrë të qartë

Projektet e Google Cloud

Projekti i parazgjedhur

Importo projekte

Nëse nuk keni importuar ende ndonjë projekt, ndiqni këto hapa për të importuar një projekt në Google Cloud dhe për të krijuar një çelës:

Shkoni te Google AI Studio .
Hapni Panelin e Kontrollit nga paneli anësor i majtë.
Zgjidhni Projektet .
Zgjidhni butonin Importo projekte në faqen Projekte .
Kërko dhe zgjidh projektin Google Cloud që dëshiron të importosh dhe zgjidh butonin Importo .

Pasi të importohet një projekt, shkoni te faqja Çelësat API nga menyja Dashboard dhe krijoni një çelës API në projektin që sapo importuat.

Kufizime

Më poshtë janë kufizimet e menaxhimit të çelësave API dhe projekteve të Google Cloud në Google AI Studio.

Mund të krijoni maksimumi 10 projekte në të njëjtën kohë nga faqja e Projekteve të Google AI Studio.
Ju mund të emërtoni dhe riemërtoni projekte dhe çelësa.
Çelësat API dhe faqet e Projekteve shfaqin një maksimum prej 100 çelësash dhe 50 projektesh.
Shfaqen vetëm çelësat API që nuk kanë kufizime ose janë të kufizuar në API-n e Gjuhës Gjenerative.

Për akses shtesë në menaxhim të projekteve tuaja, vizitoni Google Cloud Console.

Vendosja e çelësit API si një ndryshore mjedisi

Nëse po përdorni REST API ose JavaScript në shfletues, do t'ju duhet të jepni çelësin API në mënyrë të qartë.

Ja se si mund ta caktoni çelësin tuaj API lokalisht si variablin e mjedisit GEMINI_API_KEY me sisteme të ndryshme operative.

Linux/macOS - Bash

Bash është një konfigurim i zakonshëm i terminalit Linux dhe macOS. Mund të kontrolloni nëse keni një skedar konfigurimi për të duke ekzekutuar komandën e mëposhtme:

~/.bashrc

Nëse përgjigjja është "Nuk ka skedar ose direktori të tillë", do t'ju duhet ta krijoni këtë skedar dhe ta hapni duke ekzekutuar komandat e mëposhtme ose duke përdorur zsh :

touch ~/.bashrc
open ~/.bashrc

Tjetra, duhet të vendosni çelësin tuaj API duke shtuar komandën e mëposhtme të eksportit:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Pasi ta ruani skedarin, aplikoni ndryshimet duke ekzekutuar komandën:

source ~/.bashrc

macOS - Zsh

Zsh është një konfigurim i zakonshëm i terminalit Linux dhe macOS. Mund të kontrolloni nëse keni një skedar konfigurimi për të duke ekzekutuar komandën e mëposhtme:

~/.zshrc

Nëse përgjigjja është "Nuk ka skedar ose direktori të tillë", do t'ju duhet të krijoni këtë skedar dhe ta hapni duke ekzekutuar komandat e mëposhtme ose duke përdorur bash :

touch ~/.zshrc
open ~/.zshrc

Tjetra, duhet të vendosni çelësin tuaj API duke shtuar komandën e mëposhtme të eksportit:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Pasi ta ruani skedarin, aplikoni ndryshimet duke ekzekutuar komandën:

source ~/.zshrc

Windows

Kërko për "Variablat e Mjedisit" në shiritin e kërkimit.
Zgjidhni të modifikoni Cilësimet e Sistemit . Mund t'ju duhet të konfirmoni që dëshironi ta bëni këtë.
Në dialogun e cilësimeve të sistemit, klikoni butonin e etiketuar Variablat e Mjedisit .
Nën Variablat e përdoruesit (për përdoruesin aktual) ose Variablat e sistemit (vlen për të gjithë përdoruesit që përdorin makinën), klikoni I ri...
Specifikoni emrin e variablit si GEMINI_API_KEY . Specifikoni Çelësin tuaj Gemini API si vlerën e variablit.
Klikoni OK për të aplikuar ndryshimet.
Hapni një sesion të ri terminali (cmd ose Powershell) për të marrë variablin e ri.

Dhënia e çelësit API në mënyrë të qartë

Në disa raste, mund të dëshironi të jepni në mënyrë të qartë një çelës API. Për shembull:

Po kryeni një thirrje të thjeshtë API dhe preferoni ta kodoni fort çelësin API.
Ju dëshironi kontroll të qartë pa pasur nevojë të mbështeteni në zbulimin automatik të variablave të mjedisit nga libraritë e API-t Gemini.
Po përdorni një mjedis ku variablat e mjedisit nuk mbështeten (p.sh. web) ose po bëni thirrje REST.

Më poshtë janë shembuj se si mund të jepni një çelës API në mënyrë të qartë:

Python

from google import genai

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

response = client.models.generate_content(
    model="gemini-2.5-flash", contents="Explain how AI works in a few words"
)
print(response.text)

JavaScript

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

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

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.5-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

Shko

package main

import (
    "context"
    "fmt"
    "log"
    "google.golang.org/genai"
)

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

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-2.5-flash",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}

Java

package com.example;

import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    Client client = Client.builder().apiKey("YOUR_API_KEY").build();

    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-2.5-flash",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.text());
  }
}

PUSHTIM

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Mbajeni çelësin tuaj API të sigurt

Rregullat kritike të sigurisë

Mos i vendosni kurrë çelësat API në kontrollin e burimit. Mos e kontrolloni çelësin tuaj API në sistemet e kontrollit të versioneve si Git.
Mos i ekspozoni kurrë çelësat API në anën e klientit. Mos e përdorni çelësin tuaj API direkt në aplikacionet web ose celularë në prodhim. Çelësat në kodin e anës së klientit (duke përfshirë bibliotekat tona JavaScript/TypeScript dhe thirrjet REST) mund të nxirren.

Praktikat më të mira

Përdorni thirrje nga ana e serverit me çelësa API. Mënyra më e sigurt për të përdorur çelësin tuaj API është të thirrni API-n Gemini nga një aplikacion nga ana e serverit ku çelësi mund të mbahet konfidencial.
Përdorni tokena kalimtarë për akses nga ana e klientit (vetëm Live API): Për akses të drejtpërdrejtë nga ana e klientit në Live API, mund të përdorni tokena kalimtarë. Ato vijnë me rreziqe më të ulëta sigurie dhe mund të jenë të përshtatshme për përdorim në prodhim. Rishikoni udhëzuesin e tokenave kalimtarë për më shumë informacion.
Konsideroni shtimin e kufizimeve në çelësin tuaj: Mund të kufizoni lejet e një çelësi duke shtuar kufizime për çelësin API . Kjo minimizon dëmin e mundshëm nëse çelësi rrjedh ndonjëherë.

Për disa praktika më të mira të përgjithshme, mund të rishikoni edhe këtë artikull mbështetës .