Overovanie, API kľúče a organizácia
Na tejto strane
Overovanie, API kľúče a organizácia
Skôr než napíšeš prvý riadok kódu, musíš si nakonfigurovať prístup k API. Táto lekcia pokrýva vytváranie kľúčov, štruktúrovanie prístupu prostredníctvom organizácií a projektov a bezpečnostné opatrenia, ktoré ťa ochránia pred klasickou nočnou morou: náhodným odoslaním kľúča do verejného repozitára, kde ho cudzia osoba cez noc zneužije.
Vytvorenie účtu a získanie kľúča
Proces pozostáva z troch krokov. Najprv choď na platform.openai.com a vytvor si účet; automaticky dostaneš bezplatné kredity na začatie experimentovania. Ďalej prejdite do sekcie API Keys na dashboarde a vygeneruj nový kľúč. Tento kľúč uvidíš iba raz: okamžite si ho skopíruj, ale nevkladaj ho priamo do svojho kódu.
# Tvoj API kľúč vyzerá takto (nikdy ho nezdieľaj!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Najlepšia prax: použitie premennej prostredia
import os
api_key = os.environ.get("OPENAI_API_KEY")
Tretím krokom je deklarácia premennej prostredia, ktorá závisí od tvojej platformy. Na vývojovom stroji je často najpohodlnejší súbor .env načítaný pomocou python-dotenv. Na serveri uprednostni premennú prostredia definovanú tvojim orchestrátorom alebo službou pre tajomstvá.
# Linux / macOS — pridaj do ~/.bashrc alebo ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"
# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"
# Súbor .env (s python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here
Aký typ kľúča si vybrať
Kľúče projektu, identifikovateľné podľa prefixu sk-proj-, sú viazané na konkrétny projekt a ponúkajú najlepšiu kontrolu. Tieto budeš používať takmer vo všetkých prípadoch. SDK ich deteguje automaticky, akonáhle je nastavená premenná prostredia, čo je dôvod, prečo sa OpenAI() vo všetkých príkladoch v tomto kurze inštaluje bez argumentov.
from openai import OpenAI
# SDK automaticky deteguje OPENAI_API_KEY
client = OpenAI()
# Alebo špecifikuj explicitne (neodporúča sa pre produkciu)
client = OpenAI(api_key="sk-proj-...")
Druhým typom sú servisné kľúče. Sú určené pre serverové aplikácie vyžadujúce zvýšený prístup, udeľujú ďalšie oprávnenia, a preto si vyžadujú extra opatrnosť: ukladaj ich do trezoru tajomstiev a nikdy ich hodnotu nedistribuuj na vývojovú pracovnú stanicu.
Organizácie a projekty
Prístup je štruktúrovaný na troch vnorených úrovniach:
- Organizácia: Tvoja spoločnosť alebo tím
- Projekt: Logické zoskupenie (napr. „Produkčný chatbot“, „Analýza dát“)
- API kľúč: Prepojený s konkrétnym projektom
Ak patríš do viacerých organizácií, pri inštalácii klienta špecifikuj tú, ktorú chceš použiť:
from openai import OpenAI
# Špecifikuj organizáciu (užitočné, ak patríš do viacerých)
client = OpenAI(
organization="org-xxxxxxxxxxxx",
project="proj-xxxxxxxxxxxx"
)
Venuj čas rozdeleniu svojho využitia do projektov namiesto smerovania všetkého cez jediný kľúč. Výhody uvidíš pri prvých problémoch. Každý projekt má vlastné sledovanie využitia, čo ti umožňuje pripísať náklady konkrétnej funkcii namiesto nejasného mesačného súčtu. Limity rýchlosti sú tiež oddelené: nočná dávková úloha, ktorá vyčerpá svoju kvótu, nezabráni tvojmu chatbotu odpovedať zákazníkom. Následne môžeš priradiť rôznych členov ku každému projektu a čo je kľúčové, zrušiť kompromitovaný kľúč bez prerušenia ostatných aplikácií.
Nikdy neodhaľuj svoje kľúče
Pravidlo je jednoduché a absolútne: kľúč sa nikdy neobjaví v zdrojovom kóde. Kontrast medzi dvoma úryvkami nižšie hovorí viac než dlhá prednáška.
# ZLE — natvrdo zakódovaný kľúč v kóde
client = OpenAI(api_key="sk-proj-abc123") # NEBEZPEČENSTVO!
# DOBRE — premenná prostredia
client = OpenAI() # Automaticky číta OPENAI_API_KEY
# DOBRE — súbor .env s python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
Dôsledkom sa týka tvojho .gitignore, ktorý musí vylúčiť lokálne konfiguračné súbory pred prvým commitom, nie až po ňom. Kľúč, ktorý je zverejnený a následne vymazaný, zostáva prítomný v histórii repozitára.
# VŽDY pridaj tieto riadky do svojho .gitignore
.env
.env.local
.env.production
*.key
Nakoniec plánuj pravidelnú rotáciu, každých 90 dní. Môžeš to urobiť bez výpadku: vytvor nový kľúč, aktualizuj svoje nasadenia a starý kľúč vymaž až vtedy, keď ho už nič nepoužíva.
Overenie konfigurácie
Skôr než budeš pokračovať, spusti tento skript. Skontroluje prítomnosť kľúča, zobrazí jeho skrátenú veriu na potvrdenie, že ide o správny kľúč, a následne vykoná skutočný volanie. Tento test znova spusti vždy, keď sa prostredie správa podivne.
from openai import OpenAI
import os
def verify_configuration():
"""Overenie správnosti konfigurácie API."""
# Kontrola prítomnosti kľúča
api_key = os.environ.get("OPENAI_API_KEY")
if not api_key:
print("CHYBA: OPENAI_API_KEY nie je definovaná")
return False
print(f"Kľúč detegovaný: {api_key[:8]}...{api_key[-4:]}")
# Test pripojenia
try:
client = OpenAI()
response = client.responses.create(
model="gpt-5.6-terra",
input="Reply only: OK"
)
print(f"Pripojenie úspešné: {response.output_text}")
return True
except Exception as e:
print(f"CHYBA pripojenia: {e}")
return False
verify_configuration()
# Očakávaný výsledok:
# Kľúč detegovaný: sk-proj-...xxxx
# Pripojenie úspešné: OK
Kľúčové poznatky
- Používaj kľúče projektu (
sk-proj-...) pre každú aplikáciu - Ukladaj svoje kľúče do premenných prostredia, nikdy nie do kódu
- Organizuj svoj prístup pomocou hierarchie Organizácia → Projekt → Kľúč
- Vykonávaj pravidelnú rotáciu svojich kľúčov (každých 90 dní)
- Vždy pridaj
.envdo svojho.gitignore