Ugrás a fő tartalomra

Google AI Studio API key

Google AI Studio API key





Képzeld el úgy a Google AI Studio-t, mint egy műhelyt, ahol a Google legújabb modelljeivel (Gemini 1.5 Pro, Flash stb.) kísérletezhetsz. Ahhoz, hogy a saját programodból (legyen az Python szkript, weboldal vagy mobilapp) elérd ezt a műhelyt, szükséged van egy belépőkártyára. Ez az API kulcs.


1. Mi az API Kulcs (API Key) szerepe?

Az API kulcs egy egyedi, hosszú karakterlánc (string), ami a "titkos jelszavadként" funkcionál a Google szerverei felé. Három fő feladata van:

  • Hitelesítés (Authentication): Ez mondja meg a Google-nek, hogy "ki vagy te". A kulcs azonosítja a Google Cloud projektedet, amelyhez a kérések tartoznak.

  • Jogosultság-kezelés (Authorization): Bár az AI Studio kulcsok általában teljes hozzáférést adnak a Gemini modellekhez, technikailag ez a kulcs engedélyezi, hogy a kódod futtathassa a modelleket (inference).

  • Kvóták és Számlázás (Rate Limiting & Billing): Ez alapján számolja a Google, hogy hány kérést küldtél (RPM - Requests Per Minute) és hány tokent használtál el. Ez határozza meg, hogy ingyenes sávban maradsz-e, vagy fizetned kell.

2. Hogyan kell használni? (Best Practices)

Programozóként a legfontosabb szabály: Soha ne égesd be (hardcode) a kulcsot a forráskódba!

A kulcs létrehozása:

  1. Nyisd meg a Google AI Studio felületét.

  2. A bal oldali menüben kattints a "Get API key" gombra.

  3. Válaszd a "Create API key" opciót (hozzárendelheted egy új vagy egy meglévő Google Cloud projekthez).

A kulcs biztonságos használata Pythonban:

A modern fejlesztésben környezeti változókat (Environment Variables) használunk. Így a kulcs nem kerül fel a GitHubra véletlenül sem.

Szükséges csomagok telepítése:


pip install -q -U google-generativeai python-dotenv

A .env fájl létrehozása (ebben tároljuk a titkot): Hozz létre egy fájlt .env néven a projekt gyökerében, és írd bele:

Plaintext
GOOGLE_API_KEY=AIzaSy... (ide másold a teljes kulcsodat)

Python kód:

import os
import google.generativeai as genai
from dotenv import load_dotenv

# 1. Betöltjük a környezeti változókat a .env fájlból
load_dotenv()

# 2. Elkérjük a kulcsot
api_key = os.getenv("GOOGLE_API_KEY")

if not api_key:
    raise ValueError("Nem található API kulcs! Ellenőrizd a .env fájlt.")

# 3. Konfiguráljuk a klienst
genai.configure(api_key=api_key)

# 4. Modell inicializálása
model = genai.GenerativeModel('gemini-1.5-flash')

# 5. Használat
response = model.generate_content("Írj egy Hello World programot Pythonban!")
print(response.text)

3. Az API Kulcs típusai és szintjei

Bár technikailag a "kulcs" kinézete mindig ugyanolyan, a mögötte álló szolgáltatási szint (Tier) határozza meg a képességeit. A Google AI Studio-ban jelenleg két fő mód van, ami a kulcshoz rendelt projekttől függ:

A. Ingyenes szint (Free Tier)

Ez az alapértelmezett, amikor csak kísérletezel.

  • Költség: $0.

  • Korlátok (Rate Limits): Van egy napi és percenkénti limit (pl. 15 RPM - kérés/perc). Ha ezt túlléped, 429 Too Many Requests hibát kapsz.

  • Adatvédelem (FONTOS!): > Figyelem: A Free Tier-ben küldött adatokat (promptokat, feltöltött fájlokat) a Google felhasználhatja a modelljei tanítására és finomhangolására. Éles, üzleti titkokat tartalmazó adatot ebben a módban tilos kezelni.

B. Fizetős szint (Pay-as-you-go / Enterprise)

Ha a Google Cloud projektedben beállítod a számlázást (Billing account), átváltasz ebbe a módba.

  • Költség: Használat alapú (1 millió tokenenként fizetsz bemenet/kimenet alapján).

  • Korlátok: Sokkal magasabbak a limitek (pl. 1000+ RPM).

  • Adatvédelem: Az ebben a módban küldött adatokat a Google NEM használja fel tanításra. Üzleti alkalmazásokhoz ez kötelező.

Biztonsági összefoglaló (A "Ne csináld" lista)

  1. Git commit: Soha ne töltsd fel a .env fájlt a verziókezelőbe. Mindig add hozzá a .gitignore fájlhoz!

  2. Client-side: Ne használd az API kulcsot közvetlenül kliens oldali kódban (pl. React app, ami a böngészőben fut), mert bárki ellophatja a "Network" fülön. Ha weboldalt készítesz, a kérést mindig a saját backend szerveredről (pl. Node.js, Python, Go) küldd a Google felé.

 



Kocka varázs app link:

https://ai.studio/apps/drive/1J4AK9iYUmURHytSPIvFSfvyUl86ge5y-?fullscreenApplet=true


Megjegyzések

Megjegyzés küldése