Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Avtentikacija, ključi API in organizacija

Lekcija 3 od 22 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Avtentikacija, ključi API in organizacija
  2. Ustvari račun in pridobi ključ
  3. Katero vrsto ključa izbrati
  4. Organizacije in projekti
  5. Nikoli ne razkrij svojih ključev
  6. Preveri svojo konfiguracijo
  7. Ključne ugotovitve

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:

  1. Organizacija: Tvoje podjetje ali ekipa
  2. Projekt: Logično združevanje (npr. „Produkcijski klepetalni bot”, „Analiza podatkov”)
  3. 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 .env v svoj .gitignore