Inštalácia Python SDK
Na tejto strane
Inštalácia Python SDK
Python SDK openai je oficiálna knižnica na interakciu s API. V tejto lekcii si prejdeme inštaláciou a nastavíme čistú štruktúru projektu, ktorú budeš používať počas celého zvyšku kurzu.
Predpoklady a inštalácia
Potrebuješ Python 3.10 alebo novší – čo je minimum požadované SDK openai (verzia 3.42.1 k 2. novembru 2026 podľa PyPI), správca balíkov (pip alebo uv) a API kľúč, ktorý si získal v predchádzajúcej lekcii. Najprv si over svoju interpretáciu, keďže vývojárske stroje často hostia viacero verzií:
python --version
# Python 3.12.4
Inštalácia zaberie jediný príkaz: pip install openai, alebo uv pip install openai, ak používaš uv, čo je výrazne rýchlejšie. Zvykni si však pracovať vo virtuálnom prostredí. Predídeš tak bežnej situácii, keď o šesť mesiacov zistíš, že dva projekty vyžadujú nekompatibilné verzie tej istej knižnice.
# Vytvorenie virtuálneho prostredia
python -m venv .venv
# Aktivácia (Linux/macOS)
source .venv/bin/activate
# Aktivácia (Windows)
.venv\Scripts\activate
# Inštalácia SDK
pip install openai
Dvaja spoločníci sa objavujú takmer v každom projekte a zaslúžia si inštaláciu spolu so SDK. Pydantic pomáha definovať schémy pre štruktúrovaný výstup, čo uvidíš neskôr; python-dotenv načítava súbor .env do premenných prostredia.
# Inštalácia s podporou dátových tried Pydantic
pip install openai pydantic
# Inštalácia s python-dotenv pre premenné prostredia
pip install openai python-dotenv
Nakoniec over, či import funguje, a zaznamenaj si nainštalovanú verziu. Toto je prvá informácia, ktorú máš poskytnúť, ak otvoríš tiket podpory.
import openai
print(f"OpenAI SDK version: {openai.__version__}")
# Output: OpenAI SDK version: 1.68.0 (or newer)
Jeden klient, všetky API
SDK sa točí okolo jediného objektu klienta, ktorý sprístupňuje celú platformu prostredníctvom podmodulov. Nepotrebuješ inštalovať nič nové, aby si prepol z generovania textu na vektory (embeddings) alebo moderovanie.
from openai import OpenAI
client = OpenAI()
# Responses API (text, volanie funkcií, štruktúrovaný výstup)
client.responses.create(...)
# Chat Completions API (staršie)
client.chat.completions.create(...)
# Embeddings
client.embeddings.create(...)
# Obrázky
client.images.generate(...)
# Audio
client.audio.transcriptions.create(...)
client.audio.speech.create(...)
# Moderovanie
client.moderations.create(...)
Konfigurácia klienta pre tvoj kontext
Predvolené nastavenia SDK fungujú na experimentovanie, ale pre webové aplikácie nestačia. Predvolený časový limit je desať minút: v HTTP API, od ktorého sa očakáva odpoveď v priebehu sekúnd, to znamená, že zaseknutá požiadavka zviaže worker príliš dlho. Skráť ho a zvýš počet automatických opakovaní, ktorý je predvolene nastavený na dva.
from openai import OpenAI
client = OpenAI(
timeout=60.0, # 60 sekúnd (predvolené: 10 minút)
max_retries=3, # 3 pokusy pri chybe (predvolené: 2)
)
Parameter base_url rieši ďalšiu potrebu: smerovanie volaní cez firemný proxy server, ktorý loguje odchádzajúcu premávku, alebo na službu vystavujúcu kompatibilné API.
# Užitočné pre firemné proxy alebo kompatibilné API
client = OpenAI(
base_url="https://your-proxy.company.com/v1"
)
Nakoniec, ak sa tvoja aplikácia spolieha na asyncio – FastAPI, aiohttp a podobne – použij AsyncOpenAI. Synchronný klient by počas generovania blokoval slučku udalostí, čím by negoval výhody asynchrónneho kódu.
from openai import AsyncOpenAI
async_client = AsyncOpenAI()
# Použitie s await
import asyncio
async def main():
response = await async_client.responses.create(
model="gpt-5.6-terra",
input="Hello!"
)
print(response.output_text)
asyncio.run(main())
# Output: Hello! How can I help you today?
Štruktúrovanie projektu
Hneď na začiatku prijmi organizáciu, ktorá izoluje konfiguráciu klienta od zvyšku tvojho kódu. Tým sa vyhneš roztrúseniu desiatok volaní OpenAI() po celom projekte, každého s vlastnými nastaveniami.
my-project/
├── .env # API kľúč (NIKDY neodosielaj do git)
├── .gitignore # Zahŕňa .env
├── requirements.txt # Závislosti
├── src/
│ ├── __init__.py
│ ├── client.py # Konfigurácia klienta OpenAI
│ └── main.py # Vstupný bod
└── tests/
└── test_api.py
Súbor src/client.py centralizuje továreň na klienta: v deň, keď zmeníš časový limit alebo pridáš proxy, potrebuješ upraviť iba jedno miesto.
from openai import OpenAI
from dotenv import load_dotenv
load_dotenv()
def get_client() -> OpenAI:
"""Vráti nakonfigurovaného klienta OpenAI."""
return OpenAI(
max_retries=3,
timeout=30.0
)
A requirements.txt fixuje minimálne očakávané verzie:
openai>=1.60.0
python-dotenv>=1.0.0
pydantic>=2.0.0
Tri bežné zlyhania
Chyba ModuleNotFoundError pri openai takmer vždy signalizuje neaktívne virtuálne prostredie alebo iné prostredie, než do ktorého si balík nainštaloval. Nájdi interpret, ktorý sa skutočne používa, pomocou which python na Linuxe a macOS, alebo where python na Windows, a potom preinštaluj príkazom pip install --upgrade openai. Chyba AuthenticationError ukazuje na premennú prostredia: vypíš os.environ.get("OPENAI_API_KEY", "NOT DEFINED"), aby si vylúčil problémy – súbor .env sa nenačíta, ak pred inštaláciou klienta nebola zavolaná funkcia load_dotenv(). Nakoniec, chyba týkajúca sa neznámeho parametra zvyčajne naznačuje, že SDK je príliš staré na funkciu, ktorú používaš: toto vyrieši pip install --upgrade openai.
Kľúčové poznatky
- Nainštaluj SDK pomocou
pip install openaivo virtuálnom prostredí - Klient
OpenAI()je vstupným bodom pre všetky API - Pre asynchrónne aplikácie použij
AsyncOpenAI() - Časový limit a opakovania nakonfiguruj podľa svojich potrieb
- Štruktúruj svoj projekt so súborom
.enva centralizovaným klientom