Merrni një çelës API të Gemini

Për të përdorur Gemini API, ju nevojitet një çelës API. Mund të krijoni një çelës me disa klikime në Google AI Studio.

Merrni një çelës API Gemini në Google AI Studio

Konfiguro çelësin tënd API

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. Pjesa tjetër e këtij seksioni tregon se si të konfiguroni çelësin tuaj API në nivel lokal si një variabël mjedisi me sisteme të ndryshme operative.

Linux/macOS - Bash macOS - Zsh Dritaret

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

~/.bashrc

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

touch ~/.bashrc
open ~/.bashrc

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

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Pas ruajtjes së skedarit, aplikoni ndryshimet duke ekzekutuar:

source ~/.bashrc

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

~/.zshrc

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

touch ~/.zshrc
open ~/.zshrc

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

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Pas ruajtjes së skedarit, aplikoni ndryshimet duke ekzekutuar:

source ~/.zshrc
  1. Kërkoni "Ndryshoret e Mjedisit" në cilësimet e sistemit
  2. Ndryshoni ose "Ndryshoret e përdoruesit" (për përdoruesin aktual) ose "Ndryshoret e sistemit" (për të gjithë përdoruesit - përdorni me kujdes).
  3. Krijo variablin dhe shto export GEMINI_API_KEY=your_key_here
  4. Aplikoni ndryshimet

Dërgoni kërkesën tuaj të parë të Gemini API

Ju mund të përdorni një komandë curl për të verifikuar konfigurimin tuaj:

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

Mbajeni të sigurt çelësin tuaj API

Është e rëndësishme të mbani të sigurt çelësin tuaj API Gemini. Këtu janë disa gjëra që duhen mbajtur parasysh kur përdorni çelësin tuaj API Gemini:

  • Google AI Gemini API përdor çelësat API për autorizim. Nëse të tjerët kanë qasje te çelësi juaj API Gemini, ata mund të bëjnë telefonata duke përdorur kuotën e projektit tuaj, gjë që mund të rezultojë në humbje të kuotës ose tarifa shtesë për projektet e faturuara, përveç aksesit në modele dhe skedarë të sintonizuar.

  • Shtimi i kufizimeve të çelësit API mund të ndihmojë në kufizimin e sipërfaqes së përdorshme përmes secilit çelës API.

  • Ju jeni përgjegjës për mbajtjen e sigurt të çelësit tuaj API Gemini.

    • MOS kontrolloni çelësat API të Gemini në kontrollin e burimit.
    • Aplikacionet nga ana e klientit (Android, Swift, ueb dhe Dart/Flutter) rrezikojnë të ekspozojnë çelësat API. Ne nuk rekomandojmë përdorimin e SDK-ve të klientit të Google AI në aplikacionet e prodhimit për të thirrur Google AI Gemini API direkt nga aplikacionet tuaja celulare dhe të uebit.

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