Instalace Python SDK
Na této stránce
Instalace Python SDK
Python SDK openai je oficiální knihovna pro komunikaci s API. V této lekci si projdeš instalací a nastavíš si čistou strukturu projektu, kterou budeš používat po zbytek kurzu.
Požadavky a instalace
Potřebuješ Python 3.10 nebo novější – což je minimum vyžadované SDK openai (verze 3.42.1 k 2. listopadu 2026 dle PyPI), správce balíčků (pip nebo uv) a klíč API, který jsi získal v předchozí lekci. Začni ověřením svého interpretu, protože vývojářské stroje často hostují více verzí:
python --version
# Python 3.12.4
Instalace zabere jediný příkaz: pip install openai, nebo uv pip install openai, pokud používáš uv, což je výrazně rychlejší. Zvykni si však pracovat uvnitř virtuálního prostředí. Předejdeš tak běžné situaci, kdy o šest měsíců později zjistíš, že dva projekty vyžadují nekompatibilní verze téže knihovny.
# Vytvoření virtuálního prostředí
python -m venv .venv
# Aktivace (Linux/macOS)
source .venv/bin/activate
# Aktivace (Windows)
.venv\Scripts\activate
# Instalace SDK
pip install openai
Dva doprovodné nástroje se objevují téměř v každém projektu a zaslouží si instalaci společně se SDK. Pydantic pomáhá definovat schémata pro strukturovaný výstup, který uvidíš později; python-dotenv načítá soubor .env do proměnných prostředí.
# Instalace s podporou datových tříd Pydantic
pip install openai pydantic
# Instalace s python-dotenv pro proměnné prostředí
pip install openai python-dotenv
Nakonec ověř, že import funguje, a zaznamenej si nainstalovanou verzi. To je první informace, kterou musíš poskytnout, pokud otevíráš ticket na podporu.
import openai
print(f"OpenAI SDK version: {openai.__version__}")
# Výstup: OpenAI SDK version: 1.68.0 (nebo novější)
Jeden klient, všechna API
SDK se točí kolem jediného objektu klienta, který zpřístupňuje celou platformu prostřednictvím podmodulů. Nemusíš instancovat nic nového, abys přešel z generování textu na vektory (embeddings) nebo moderaci.
from openai import OpenAI
client = OpenAI()
# Responses API (text, volání funkcí, strukturovaný výstup)
client.responses.create(...)
# Chat Completions API (starší)
client.chat.completions.create(...)
# Embeddings
client.embeddings.create(...)
# Obrázky
client.images.generate(...)
# Audio
client.audio.transcriptions.create(...)
client.audio.speech.create(...)
# Moderace
client.moderations.create(...)
Konfigurace klienta pro tvůj kontext
Výchozí nastavení SDK fungují pro experimentování, ale pro webové aplikace nestačí. Výchozí časový limit je deset minut: u HTTP API, od kterého se očekává odpověď během sekund, to znamená, že zaseknutý požadavek blokuje worker příliš dlouho. Sniž ho a zvyš počet automatických opakování, který je ve výchozím nastavení dva.
from openai import OpenAI
client = OpenAI(
timeout=60.0, # 60 sekund (výchozí: 10 minut)
max_retries=3, # 3 pokusy při chybě (výchozí: 2)
)
Parametr base_url řeší další potřebu: směrování požadavků přes firemní proxy, která loguje odchozí provoz, nebo na službu vystavující kompatibilní API.
# Užitečné pro firemní proxy nebo kompatibilní API
client = OpenAI(
base_url="https://your-proxy.company.com/v1"
)
Nakonec, pokud tvoje aplikace spoléhá na asyncio – FastAPI, aiohttp a podobně – použij AsyncOpenAI. Synchronní klient by během generování blokoval smyčku událostí, čímž by negoval výhody asynchronního kódu.
from openai import AsyncOpenAI
async_client = AsyncOpenAI()
# Použití 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())
# Výstup: Hello! How can I help you today?
Struktura tvého projektu
Přijmi organizaci, která od samého začátku odděluje konfiguraci klienta od zbytku kódu. Tím se vyhneš rozmístění desítek volání OpenAI() po celém projektu, každého s vlastním nastavením.
my-project/
├── .env # Klíč API (NIKDY necommitovat do git)
├── .gitignore # Zahrnuje .env
├── requirements.txt # Závislosti
├── src/
│ ├── __init__.py
│ ├── client.py # Konfigurace klienta OpenAI
│ └── main.py # Vstupní bod
└── tests/
└── test_api.py
Soubor src/client.py centralizuje továrnu na klienty: v den, kdy změníš časový limit nebo přidáš proxy, stačí upravit pouze jedno místo.
from openai import OpenAI
from dotenv import load_dotenv
load_dotenv()
def get_client() -> OpenAI:
"""Vrací nakonfigurovaného klienta OpenAI."""
return OpenAI(
max_retries=3,
timeout=30.0
)
A requirements.txt připíná minimální očekávané verze:
openai>=1.60.0
python-dotenv>=1.0.0
pydantic>=2.0.0
Tři časté chyby
Chyba ModuleNotFoundError u openai téměř vždy signalizuje neaktivní virtuální prostředí nebo jiné než to, do kterého jsi balíček instaloval. Najdi interpret, který se skutečně používá, pomocí which python na Linuxu a macOS nebo where python na Windows, a poté přeinstaluj pomocí pip install --upgrade openai. Chyba AuthenticationError ukazuje na proměnnou prostředí: vytiskni os.environ.get("OPENAI_API_KEY", "NOT DEFINED"), abys vyloučil problémy – soubor .env se nenačte, pokud nebylo před instanciací klienta zavoláno load_dotenv(). Nakonec chyba týkající se neznámého parametru obvykle znamená, že je SDK příliš staré na funkci, kterou používáš: pip install --upgrade openai toto vyřeší.
Klíčové poznatky
- Nainstaluj SDK pomocí
pip install openaiuvnitř virtuálního prostředí - Klient
OpenAI()je vstupním bodem pro všechna API - Pro asynchronní aplikace použij
AsyncOpenAI() - Nakonfiguruj časový limit a opakování podle svých potřeb
- Strukturovej projekt se souborem
.enva centralizovaným klientem