Avtentikacija, ključi API in organizacija
Na tej strani
Avtentikacija, ključi API in organizacija
Preden napišeš prvo vrstico kode, moraš konfigurirati dostop do API-ja. Ta lekcija pokriva ustvarjanje ključev, strukturiranje dostopa prek organizacij in projektov ter varnostne ukrepe, ki preprečujejo klasično nočno moro: nenamerno objavo ključa v javnem repozitoriju, kjer ga čez noč izkoristi neznanec.
Ustvari račun in pridobi ključ
Postopek obsega tri korake. Najprej obišči platform.openai.com in ustvari račun; samodejno boš prejel brezplačne kredite za začetek eksperimentiranja. Nato se pomakni v razdelek API Keys na nadzorni plošči in ustvari nov ključ. Ta ključ boš videl le enkrat: takoj ga kopiraj, vendar ga ne prilepi v svojo kodo.
# Tvoj ključ API izgleda tako (nikoli ga ne deli!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Najboljša praksa: uporaba spremenljivke okolja
import os
api_key = os.environ.get("OPENAI_API_KEY")
Tretji korak je deklaracija spremenljivke okolja, kar je odvisno od tvoje platforme. Na razvojnem računalniku je datoteka .env, ki jo naloži python-dotenv, pogosto najbolj priročna rešitev. Na strežniku raje uporabi spremenljivko okolja, ki jo določi tvoj orkestrator ali storitev za upravljanje skrivnosti.
# Linux / macOS — dodaj v ~/.bashrc ali ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"
# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"
# Datoteka .env (s python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here
Katero vrsto ključa izbrati
Ključi projekta, prepoznavni po predponi sk-proj-, so vezani na določen projekt in nudijo najboljši nadzor. Uporabljal jih boš v skoraj vsakem primeru. SDK jih samodejno zazna, ko je spremenljivka okolja nastavljena, zato se OpenAI() v vseh primerih v tem tečaju inicializira brez argumentov.
from openai import OpenAI
# SDK samodejno zazna OPENAI_API_KEY
client = OpenAI()
# Ali določi eksplicitno (ni priporočljivo za produkcijo)
client = OpenAI(api_key="sk-proj-...")
Storitveni ključi so druga vrsta. Zasnovani so za strežniške aplikacije, ki zahtevajo povišan dostop; podeljujejo dodatna dovoljenja in zato zahtevajo posebno skrb: shrani jih v trezor skrivnosti in njihove vrednosti nikoli ne posreduj na razvojno delovno postajo.
Organizacije in projekti
Dostop je strukturiran na treh gnezdenih ravneh:
- Organizacija: Tvoje podjetje ali ekipa
- Projekt: Logično združevanje (npr. „Produkcijski klepetalni bot”, „Analiza podatkov”)
- Ključ API: Povezan z določenim projektom
Če pripadaš več organizacijam, ob inicializaciji odjemalca določi tisto, ki jo nameravaš uporabiti:
from openai import OpenAI
# Določi organizacijo (uporabno, če pripadaš več organizacijam)
client = OpenAI(
organization="org-xxxxxxxxxxxx",
project="proj-xxxxxxxxxxxx"
)
Vzemi si čas in uporabo razdeli na projekte, namesto da vse usmerjaš prek enega samega ključa. Prednost tega boš videl ob prvih težavah. Vsak projekt ima svoje sledenje uporabe, kar ti omogoča, da stroške pripišeš določeni funkcionalnosti namesto nejasnemu mesečnemu seštevku. Tudi omejitve hitrosti so ločene: nočno serijsko opravilo, ki izčrpa svojo kvoto, ne bo preprečilo tvojemu klepetalnemu botu, da bi odgovarjal strankam. Vsakemu projektu lahko dodeliš različne člane in, kar je ključno, prekineš kompromitiran ključ, ne da bi motil druge aplikacije.
Nikoli ne razkrij svojih ključev
Pravilo je preprosto in absolutno: ključ se nikoli ne pojavi v izvorni kodi. Kontrast med spodnjima dvema izsekode govori glasneje kot dolg predavanji.
# SLABO — ključ vgrajen v kodo
client = OpenAI(api_key="sk-proj-abc123") # NEVARNOST!
# DOBRO — spremenljivka okolja
client = OpenAI() # Samodejno prebere OPENAI_API_KEY
# DOBRO — datoteka .env s python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
Posledica tega se nanaša na tvojo datoteko .gitignore, ki mora izključiti lokalne konfiguracijske datoteke pred prvo potrditvijo (commit), ne šele po njej. Ključ, ki je objavljen in nato izbrisan, ostane prisoten v zgodovini repozitorija.
# VEDNO dodaj te vrstice v svoj .gitignore
.env
.env.local
.env.production
*.key
Na koncu načrtuj redno menjavo ključev, vsakih 90 dni. To lahko storiš brez zastojev: ustvari nov ključ, posodobi svoje namestitve in šele ko nič več ne uporablja starega, ga izbriši.
Preveri svojo konfiguracijo
Preden nadaljuješ, zaženi to skripto. Preveri prisotnost ključa, prikaže okrnjeno različico za potrditev, da gre za pravega, in nato opravi dejanski klic. Ta test ponovi vsakič, ko se okolje obnaša čudno.
from openai import OpenAI
import os
def verify_configuration():
"""Preveri, ali je konfiguracija API-ja pravilna."""
# Preveri prisotnost ključa
api_key = os.environ.get("OPENAI_API_KEY")
if not api_key:
print("NAPAKA: OPENAI_API_KEY ni definiran")
return False
print(f"Ključ zaznan: {api_key[:8]}...{api_key[-4:]}")
# Preizkusi povezavo
try:
client = OpenAI()
response = client.responses.create(
model="gpt-5.6-terra",
input="Reply only: OK"
)
print(f"Povezava uspešna: {response.output_text}")
return True
except Exception as e:
print(f"NAPAKA povezave: {e}")
return False
verify_configuration()
# Pričakovani rezultat:
# Ključ zaznan: sk-proj-...xxxx
# Povezava uspešna: OK
Ključne ugotovitve
- Za vsako aplikacijo uporabi ključe projekta (
sk-proj-...) - Ključe shrani v spremenljivke okolja, nikoli v kodo
- Svoj dostop organiziraj s hierarhijo Organizacija → Projekt → Ključ
- Izvajaj redno menjavo ključev (vsakih 90 dni)
- Vedno dodaj
.envv svoj.gitignore