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 koduar që mund ta përdorni kur telefononi API të Google Cloud. Ju mund të krijoni dhe menaxhoni të gjithë çelësat tuaj të API-së Gemini nga faqja e çelësave të API-së së Studio AI të Google .

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

• Vendosja e çelësit tuaj API si një variabël mjedisi
• Sigurimi i çelësit tuaj API në mënyrë eksplicite

Për testimin fillestar, mund të kodoni një çelës API, por ky duhet të jetë vetëm i përkohshëm pasi nuk është i sigurt. Mund të gjeni shembuj për kodimin e fortë të çelësit API në seksionin Sigurimi i çelësit API në mënyrë eksplicite .

Projektet e Google Cloud

Projektet e Google Cloud janë thelbësore për përdorimin e shërbimeve të Google Cloud (të tilla si 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 në Google Cloud.

Nëse nuk keni krijuar ende ndonjë projekt, ose 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ë projekteve të importit për udhëzime.

Projektet e importit

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

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

1. Shkoni te Google AI Studio .
2. Hapni panelin e kontrollit nga paneli i majtë.
3. Zgjidhni Projektet .
4. Zgjidhni butonin Importo projekte në faqen Projektet .
5. Kërkoni dhe zgjidhni projektin Google Cloud që dëshironi të importoni dhe zgjidhni butonin Import .

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

Kufizimet

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

• Mund të krijoni një maksimum prej 10 projektesh në të njëjtën kohë nga faqja " Projektet e Studios së Google AI".
• Ju mund të emërtoni dhe riemërtoni projektet dhe çelësat.
• Çelësat API dhe faqet e Projekteve shfaqin maksimumi 100 çelësa dhe 50 projekte.
• Shfaqen vetëm çelësat API që nuk kanë kufizime ose janë të kufizuara në API të gjuhës gjeneruese.

Për akses shtesë të menaxhimit në projektet tuaja, vizitoni Google Cloud Console.

Vendosja e çelësit API si një variabël mjedisi

Nëse vendosni variablin e mjedisit GEMINI_API_KEY ose GOOGLE_API_KEY , çelësi API do të merret automatikisht nga klienti kur përdorni një nga bibliotekat e API-së Gemini . Rekomandohet që të vendosni vetëm një nga ato variabla, por nëse të dyja janë vendosur, GOOGLE_API_KEY ka përparësi.

Nëse jeni duke përdorur API REST, ose JavaScript në shfletues, do t'ju duhet të jepni në mënyrë eksplicite çelësin API.

Ja se si mund ta vendosni çelësin tuaj API në nivel lokal si variablin e mjedisit GEMINI_API_KEY me sisteme të ndryshme operative.

~/.bashrc

touch ~/.bashrc
open ~/.bashrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.bashrc

~/.zshrc

touch ~/.zshrc
open ~/.zshrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.zshrc

Sigurimi i çelësit API në mënyrë eksplicite

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

• Ju jeni duke bërë një thirrje të thjeshtë API dhe preferoni kodimin e fortë të çelësit API.
• Ju dëshironi kontroll të qartë pa pasur nevojë të mbështeteni në zbulimin automatik të variablave të mjedisit nga bibliotekat Gemini API
• Jeni duke përdorur një mjedis ku variablat e mjedisit nuk mbështeten (p.sh. ueb) ose jeni duke bërë thirrje REST.

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

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)

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();

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())
}

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());
  }
}

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 të sigurt çelësin tuaj API

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

Rregullat kritike të sigurisë

• Asnjëherë mos i vendosni çelësat API për kontrollin e burimit. Mos e kontrolloni çelësin tuaj API në sistemet e kontrollit të versioneve si Git.

• Asnjëherë mos ekspozoni çelësat API në anën e klientit. Mos e përdorni çelësin tuaj API direkt në ueb ose aplikacione celulare në prodhim. Çelësat në kodin e klientit (duke përfshirë bibliotekat tona JavaScript/TypeScript dhe thirrjet REST) ​​mund të nxirren.

Praktikat më të mira

• Përdorni telefonatat nga ana e serverit me çelësat API Mënyra më e sigurt për të përdorur çelësin tuaj API është të telefononi Gemini API nga një aplikacion nga ana e serverit ku çelësi mund të mbahet konfidencial.

• Përdorni shenja kalimtare për akses nga ana e klientit (vetëm API Live): Për qasje të drejtpërdrejtë nga ana e klientit në API Live, mund të përdorni shenja kalimtare. Ato vijnë me rreziqe më të ulëta sigurie dhe mund të jenë të përshtatshme për përdorim në prodhim. Shqyrtoni udhëzuesin e shenjave kalimtare për më shumë informacion.

• Merrni parasysh shtimin e kufizimeve në çelësin tuaj: Mund të kufizoni lejet e një çelësi duke shtuar kufizime të çelësit API . Kjo minimizon dëmtimin e mundshëm nëse çelësi rrjedh ndonjëherë.

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