A Python SDK telepítése
Ezen az oldalon
A Python SDK telepítése
Az openai Python SDK az API-val való kommunikáció hivatalos könyvtára. Ebben a leckében végigvezetünk a telepítésen, és felépítünk egy tiszta projektszerkezetet, amelyet a tanfolyam hátralévő részében használni fogsz.
Előfeltételek és telepítés
Szükséged lesz Python 3.10-es vagy újabb verzióra – ez az openai SDK minimális követelménye (a PyPI adatai szerint 2026. november 2-án a 3.42.1-es verzió a legfrissebb) –, egy csomagkezelőre (pip vagy uv), valamint az előző leckében megszerzett API-kulcsra. Kezdésnek ellenőrizd az értelmező verzióját, mivel a fejlesztői gépeken gyakran több verzió is található:
python --version
# Python 3.12.4
A telepítés egyetlen parancs: pip install openai, vagy uv pip install openai, ha az uv-t használod, ami jelentősen gyorsabb. Mindazonáltal szoktasd rá magad, hogy virtuális környezetben dolgozol. Ez megelőzi azt a gyakori helyzetet, amikor hat hónap múlva rájössz, hogy két projekted incompatibilis verziókat igényel ugyanabból a könyvtárból.
# Virtuális környezet létrehozása
python -m venv .venv
# Aktiválás (Linux/macOS)
source .venv/bin/activate
# Aktiválás (Windows)
.venv\Scripts\activate
# Az SDK telepítése
pip install openai
Két segédeszköz szinte minden projektben előfordul, és érdemes az SDK mellett ezeket is telepíteni. A Pydantic segít sémák definiálásában a Strukturált Kimenethez (Structured Output), amit később látni fogsz; a python-dotenv pedig betölti a .env fájlt a környezeti változók közé.
# Telepítés Pydantic adatosztályok támogatásával
pip install openai pydantic
# Telepítés python-dotenvvel a környezeti változók kezeléséhez
pip install openai python-dotenv
Végül ellenőrizd, hogy az importálás működik-e, és jegyezd fel a telepített verziót. Ez az első információ, amit meg kell adnod, ha támogatási jegyet nyitsz.
import openai
print(f"OpenAI SDK version: {openai.__version__}")
# Kimenet: OpenAI SDK version: 1.68.0 (vagy újabb)
Egy kliens, minden API-hoz
Az SDK egyetlen kliensobjektum köré épül, amely almodulokon keresztül teszi elérhetővé az egész platformot. Nem kell semmit újra példányosítanod, ha a szöveggenerálásról az beágyazásokra (embeddings) vagy a moderációra szeretnél váltani.
from openai import OpenAI
client = OpenAI()
# Responses API (szöveg, függvényhívás, strukturált kimenet)
client.responses.create(...)
# Chat Completions API (örökölt)
client.chat.completions.create(...)
# Beágyazások (Embeddings)
client.embeddings.create(...)
# Képek
client.images.generate(...)
# Hang
client.audio.transcriptions.create(...)
client.audio.speech.create(...)
# Moderáció
client.moderations.create(...)
A kliens konfigurálása a kontextusodhoz
Az SDK alapértelmezett beállításai kísérletezésre megfelelnek, de webes alkalmazásokhoz elégtelenek. Az alapértelmezett időtúllépés (timeout) tíz perc: egy HTTP API-nál, ahol másodpercen belül várunk választ, ez azt jelenti, hogy egy beragadt kérés túl sokáig foglal le egy munkafolyamatot. Csökkentsd ezt az értéket, és növeld az automatikus újrapróbálkozások számát, amely alapértelmezetten kettő.
from openai import OpenAI
client = OpenAI(
timeout=60.0, # 60 másodperc (alapértelmezett: 10 perc)
max_retries=3, # 3 próbálkozás hiba esetén (alapértelmezett: 2)
)
A base_url paraméter egy másik igényt elégít ki: a hívások irányítása vállalati proxy-n keresztül, amely naplózza a kimenő forgalmat, vagy egy kompatibilis API-t kiszolgáló szolgáltatás felé.
# Hasznos vállalati proxy-khoz vagy kompatibilis API-khoz
client = OpenAI(
base_url="https://your-proxy.company.com/v1"
)
Végül, ha az alkalmazásod az asyncio-ra támaszkodik – mint például a FastAPI, az aiohttp és hasonlók –, használd az AsyncOpenAI klienst. A szinkron kliens blokkolná az eseményhurkot (event loop) generálás közben, ezzel megszüntetve az aszinkron kód előnyeit.
from openai import AsyncOpenAI
async_client = AsyncOpenAI()
# Használat await-tel
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())
# Kimenet: Hello! How can I help you today?
A projekted szerkezete
Fogadj el olyan szervezést, amely már a kezdetektől elkülöníti a kliens konfigurációját a kód többi részétől. Ezzel elkerülöd, hogy tucatnyi OpenAI() hívás szóródjon szét a projektedben, mindegyik saját beállításokkal.
my-project/
├── .env # API-kulcs (SOHA ne commitold gitbe)
├── .gitignore # Tartalmazza a .env fájlt
├── requirements.txt # Függőségek
├── src/
│ ├── __init__.py
│ ├── client.py # OpenAI kliens konfiguráció
│ └── main.py # Belépési pont
└── tests/
└── test_api.py
A src/client.py fájl központosítja a kliensgyárat: azon a napon, amikor módosítod az időtúllépést vagy hozzáadsz egy proxy-t, csak egy helyen kell módosítást végezned.
from openai import OpenAI
from dotenv import load_dotenv
load_dotenv()
def get_client() -> OpenAI:
"""Visszaad egy konfigurált OpenAI klienst."""
return OpenAI(
max_retries=3,
timeout=30.0
)
A requirements.txt pedig rögzíti a minimálisan elvárt verziókat:
openai>=1.60.0
python-dotenv>=1.0.0
pydantic>=2.0.0
Három gyakori hiba
Az openai modulra vonatkozó ModuleNotFoundError szinte mindig arra utal, hogy a virtuális környezet nem aktív, vagy eltér attól, ahová a csomagot telepítetted. Keresd meg a ténylegesen használt értelmezőt a which python parancsokkal Linuxon és macOS-en, illetve a where python parancscsal Windowson, majd telepítsd újra a pip install --upgrade openai paranccsal. Az AuthenticationError a környezeti változóra mutat: írasd ki az os.environ.get("OPENAI_API_KEY", "NOT DEFINED") értékét a problémák kizárásához – a .env fájl nem töltődik be, ha a load_dotenv() hívása nem történt meg a kliens példányosítása előtt. Végül egy ismeretlen paraméterre vonatkozó hiba általában azt jelzi, hogy az SDK túl régi a használt funkcióhoz: a pip install --upgrade openai megoldja ezt.
Főbb megállapítások
- Telepítsd az SDK-t a
pip install openaiparanccsal egy virtuális környezetben - Az
OpenAI()kliens a belépési pont minden API-hoz - Használd az
AsyncOpenAI()-t aszinkron alkalmazásokhoz - Konfiguráld az időtúllépést és az újrapróbálkozások számát az igényeid alapján
- Strukturáld a projektedet egy
.envfájllal és egy központosított klienssel