Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Inštalácia Python SDK

Lekcia 4 z 22 Aktualizované 2. novembra 2026 Vývojár
Na tejto strane
  1. Inštalácia Python SDK
  2. Predpoklady a inštalácia
  3. Jeden klient, všetky API
  4. Konfigurácia klienta pre tvoj kontext
  5. Štruktúrovanie projektu
  6. Tri bežné zlyhania
  7. Kľúčové poznatky

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 openai vo 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 .env a centralizovaným klientom