Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Instalace Python SDK

Lekce 4 z 22 Aktualizováno 2. listopadu 2026 Vývojář
Na této stránce
  1. Instalace Python SDK
  2. Požadavky a instalace
  3. Jeden klient, všechna API
  4. Konfigurace klienta pro tvůj kontext
  5. Struktura tvého projektu
  6. Tři časté chyby
  7. Klíčové poznatky

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 openai uvnitř 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 .env a centralizovaným klientem