Ověření, API klíče a organizace
Na této stránce
Ověření, API klíče a organizace
Než napíšeš první řádek kódu, musíš nakonfigurovat přístup k API. Tato lekce pokrývá vytváření klíčů, strukturování přístupu prostřednictvím organizací a projektů a bezpečnostní opatření, která zabrání klasické noční můře: náhodnému odeslání klíče do veřejného repozitáře, kde ho přes noc využije cizí osoba.
Vytvoření účtu a získání klíče
Proces se skládá ze tří kroků. Nejprve přejdi na platform.openai.com a vytvoř si účet; automaticky obdržíš bezplatné kredity pro začátek experimentování. Dále přejdi do sekce API Keys na dashboardu a vygeneruj nový klíč. Tento klíč uvidíš pouze jednou: okamžitě si ho zkopíruj, ale nevkládej ho přímo do svého kódu.
# Tvůj API klíč vypadá takto (nikdy ho nesdílej!)
# sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Nejlepší praxe: použití proměnné prostředí
import os
api_key = os.environ.get("OPENAI_API_KEY")
Třetím krokem je deklarace proměnné prostředí, což závisí na tvé platformě. Na vývojovém stroji je často nejvhodnější soubor .env načítaný pomocí python-dotenv. Na serveru upřednostni proměnnou prostředí definovanou tvým orchestrátorem nebo službou pro správu tajných údajů.
# Linux / macOS — přidej do ~/.bashrc nebo ~/.zshrc
export OPENAI_API_KEY="sk-proj-your-key-here"
# Windows PowerShell
$env:OPENAI_API_KEY = "sk-proj-your-key-here"
# Soubor .env (s python-dotenv)
# .env
OPENAI_API_KEY=sk-proj-your-key-here
Jaký typ klíče vybrat
Klíče projektu, identifikovatelné podle prefixu sk-proj-, jsou svázány s konkrétním projektem a nabízejí nejlepší kontrolu. Použiješ je téměř ve všech případech. SDK je detekuje automaticky, jakmile je nastavena proměnná prostředí, což je důvod, proč se OpenAI() ve všech příkladech v tomto kurzu inicializuje bez argumentů.
from openai import OpenAI
# SDK automaticky detekuje OPENAI_API_KEY
client = OpenAI()
# Nebo urči explicitně (nedoporučeno pro produkci)
client = OpenAI(api_key="sk-proj-...")
Druhým typem jsou servisní klíče. Jsou určeny pro serverové aplikace vyžadující zvýšený přístup, udělují další oprávnění, a proto vyžadují zvýšenou opatrnost: ukládej je do trezoru pro tajné údaje a nikdy jejich hodnotu nepřenášej na vývojovou pracovní stanici.
Organizace a projekty
Přístup je strukturován do tří vnořených úrovní:
- Organizace: Tvá společnost nebo tým
- Projekt: Logické seskupení (např. „Produkční chatbot“, „Analýza dat“)
- API klíč: Propojený s konkrétním projektem
Pokud patříš do více organizací, při inicializaci klienta specifikuj tu, kterou hodláš použít:
from openai import OpenAI
# Specifikuj organizaci (užitečné, pokud patříš do více organizací)
client = OpenAI(
organization="org-xxxxxxxxxxxx",
project="proj-xxxxxxxxxxxx"
)
Věnuj čas rozdělení svého využití do jednotlivých projektů, místo abys vše směroval přes jediný klíč. Výhody pocítíš při prvních známkách potíží. Každý projekt má vlastní sledování využití, což ti umožňuje přiřadit náklady ke konkrétní funkci místo nejasného měsíčního součtu. Limity rychlosti jsou také odděleny: noční dávková úloha, která vyčerpá svou kvótu, nezabrání tvému chatbotovi odpovídat zákazníkům. Následně můžeš každému projektu přiřadit různé členy a co je zásadní, zneplatnit kompromitovaný klíč bez přerušení ostatních aplikací.
Nikdy neodhaluj své klíče
Pravidlo je jednoduché a absolutní: klíč se nikdy neobjeví ve zdrojovém kódu. Kontrast mezi následujícími dvěma úryvky mluví hlasitěji než dlouhá přednáška.
# ŠPATNĚ — klíč natvrdo v kódu
client = OpenAI(api_key="sk-proj-abc123") # NEBEZPEČÍ!
# DOBŘE — proměnná prostředí
client = OpenAI() # Automaticky čte OPENAI_API_KEY
# DOBŘE — soubor .env s python-dotenv
from dotenv import load_dotenv
load_dotenv()
client = OpenAI()
Z toho vyplývá nutnost správného nastavení .gitignore, který musí vyloučit místní konfigurační soubory ještě před tvým prvním committem, nikoliv až po něm. Klíč, který je zveřejněn a následně smazán, zůstává přítomen v historii repozitáře.
# VŽDY přidej tyto řádky do svého .gitignore
.env
.env.local
.env.production
*.key
Nakonec naplánuj pravidelnou rotaci klíčů, každých 90 dní. Můžeš to provést bez výpadků: vytvoř nový klíč, aktualizuj svá nasazení a starý klíč smaž až tehdy, když jej již nic nepoužívá.
Ověření konfigurace
Než budeš pokračovat, spusť tento skript. Zkontroluje přítomnost klíče, zobrazí jeho zkrácenou verzi pro potvrzení, že jde o ten správný, a následně provede skutečný požadavek. Tento test znovu spusť pokaždé, když se chování prostředí zdá být podezřelé.
from openai import OpenAI
import os
def verify_configuration():
"""Ověří, zda je konfigurace API správná."""
# Zkontroluj přítomnost klíče
api_key = os.environ.get("OPENAI_API_KEY")
if not api_key:
print("CHYBA: OPENAI_API_KEY není definována")
return False
print(f"Klíč detekován: {api_key[:8]}...{api_key[-4:]}")
# Otestuj připojení
try:
client = OpenAI()
response = client.responses.create(
model="gpt-5.6-terra",
input="Reply only: OK"
)
print(f"Připojení úspěšné: {response.output_text}")
return True
except Exception as e:
print(f"CHYBA připojení: {e}")
return False
verify_configuration()
# Očekávaný výsledek:
# Klíč detekován: sk-proj-...xxxx
# Připojení úspěšné: OK
Klíčové poznatky
- Pro každou aplikaci používej klíče projektu (
sk-proj-...) - Ukládej své klíče do proměnných prostředí, nikdy ne do kódu
- Organizuj svůj přístup pomocí hierarchie Organizace → Projekt → Klíč
- Prováděj pravidelnou rotaci svých klíčů (každých 90 dní)
- Vždy přidej
.envdo svého.gitignore