Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Pythoni SDK installimine

Õppetund 4 / 22 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Pythoni SDK installimine
  2. Eeltingimused ja installimine
  3. Üks klient, kõik API-d
  4. Kliendi konfigureerimine oma konteksti jaoks
  5. Projekteeri oma projekt
  6. Kolm levinud tõrget
  7. Peamised punktid

Pythoni SDK installimine

Pythoni SDK openai on ametlik teek API-ga suhtlemiseks. Selles õppetükis juhendame sind installimisprotsessis ja loome puhta projekti struktuuri, mida kasutad kogu ülejäänud kursuse vältel.

Eeltingimused ja installimine

Vajad Pythoni versiooni 3.10 või uuemat – see on openai SDK miinimumnõue (versioon 3.42.1 seisuga 2. november 2026, vastavalt PyPI-le), pakihaldurit (pip või uv) ja API võtit, mille hankisid eelmises õppetükis. Alusta oma interpretaatori kontrollimisest, kuna arendusmasinatele on sageli paigaldatud mitu versiooni:

python --version
# Python 3.12.4

Installimine võtab vaid ühe käsu: pip install openai või uv pip install openai, kui kasutad uv-d, mis on oluliselt kiirem. Siiski harjuta töötamist virtuaalses keskkonnas. See hoiab ära levinud olukorra, kus kuus kuud hiljem avastad, et kaks projekti vajavad sama teegi ühildumatuid versioone.

# Loo virtuaalne keskkond
python -m venv .venv

# Aktiveeri (Linux/macOS)
source .venv/bin/activate

# Aktiveeri (Windows)
.venv\Scripts\activate

# Installi SDK
pip install openai

Peaaegu igas projektis ilmuvad kaks kaaslast, mis väärivad installimist koos SDK-ga. Pydantic aitab defineerida skeeme struktureeritud väljundile, mida näed hiljem; python-dotenv laadib .env faili keskkonnamuutujatesse.

# Installi koos toega Pydantici andmeklassidele
pip install openai pydantic

# Installi koos python-dotenv-ga keskkonnamuutujate jaoks
pip install openai python-dotenv

Lõpuks veendu, import toimib, ja pane tähele installitud versiooni. See on esimene teave, mille peaksid esitama, kui avad tugipöördumise.

import openai
print(f"OpenAI SDK version: {openai.__version__}")
# Väljund: OpenAI SDK version: 1.68.0 (või uuem)

Üks klient, kõik API-d

SDK pöörleb ühe kliendiobjekti ümber, mis paljastab kogu platvormi alammodulite kaudu. Sa ei pea teksti genereerimiselt üleminekul manustele või modereerimisele midagi uut looma.

from openai import OpenAI

client = OpenAI()

# Responses API (tekst, funktsioonide kutsumine, struktureeritud väljund)
client.responses.create(...)

# Chat Completions API (pärand)
client.chat.completions.create(...)

# Manused
client.embeddings.create(...)

# Pildid
client.images.generate(...)

# Helifailid
client.audio.transcriptions.create(...)
client.audio.speech.create(...)

# Modereerimine
client.moderations.create(...)

Kliendi konfigureerimine oma konteksti jaoks

SDK vaikeseaded sobivad katsetamiseks, kuid jäävad lühikeseks veebirakenduste puhul. Vaikimisi aegumine on kümme minutit: HTTP API puhul, millelt oodatakse vastust sekundite jooksul, tähendab see, et takerdunud päring hõivab töötaja liiga kauaks. Vähenda seda ja suurenda automaatsete korduskatsete arvu, mis vaikimisi on kaks.

from openai import OpenAI

client = OpenAI(
    timeout=60.0,  # 60 sekundit (vaikimisi: 10 minutit)
    max_retries=3,  # 3 katset vea korral (vaikimisi: 2)
)

Parameeter base_url lahendab teise vajaduse: suunata kõned läbi ettevõtte proksi, mis logib väljuvat liiklust, või teenusele, mis pakub ühilduvat API-t.

# Kasulik ettevõtte prokside või ühilduvate API-de jaoks
client = OpenAI(
    base_url="https://your-proxy.company.com/v1"
)

Lõpuks, kui sinu rakendus tugineb asyncio-le – FastAPI, aiohttp ja sarnased – kasuta AsyncOpenAI-d. Sünkroonne klient blokeeriks sündmuste tsükli genereerimise ajal, tühistades asünkroonse koodi eelised.

from openai import AsyncOpenAI

async_client = AsyncOpenAI()

# Kasutus koos await-ga
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äljund: Hello! How can I help you today?

Projekteeri oma projekt

Võta omaks korraldus, mis eraldab kliendi konfigureerimise ülejäänud koodist juba algusest peale. See hoiab ära kümnete OpenAI() väljakutsete laialilaotamise üle kogu projekti, igaüks oma seadetega.

my-project/
├── .env                  # API võti (ÄRA KUNAGI commidi gitti)
├── .gitignore            # Sisaldab .env
├── requirements.txt      # Sõltuvused
├── src/
│   ├── __init__.py
│   ├── client.py         # OpenAI kliendi konfigureerimine
│   └── main.py           # Sisendpunkt
└── tests/
    └── test_api.py

Fail src/client.py tsentraliseerib kliendi tehase: päeval, mil muudad aegumist või lisad proksi, pead muutma vaid ühte kohta.

from openai import OpenAI
from dotenv import load_dotenv

load_dotenv()

def get_client() -> OpenAI:
    """Tagastab konfigureeritud OpenAI kliendi."""
    return OpenAI(
        max_retries=3,
        timeout=30.0
    )

Ja requirements.txt määrab kindlaks oodatavad miinimumversioonid:

openai>=1.60.0
python-dotenv>=1.0.0
pydantic>=2.0.0

Kolm levinud tõrget

ModuleNotFoundError mooduli openai puhul viitab peaaegu alati mitteaktiivsele virtuaalsele keskkonnale või sellele, mis erineb kohast, kuhu paketi installisid. Leia tegelikult kasutatav interpretaator käsuga which python Linuxis ja macOS-is või where python Windowsis, seejärel installi uuesti käsuga pip install --upgrade openai. AuthenticationError viitab keskkonnamuutujale: trüki os.environ.get("OPENAI_API_KEY", "NOT DEFINED"), et välistada probleemid – .env faili ei laadita, kui load_dotenv() ei ole enne kliendi loomist kutsutud. Lõpuks viitab viga tundmatu parameetri kohta tavaliselt SDK-le, mis on liiga vana funktsiooni jaoks, mida kasutad: pip install --upgrade openai lahendab selle.

Peamised punktid

  • Installi SDK käsuga pip install openai virtuaalses keskkonnas
  • Klient OpenAI() on kõigi API-de sisendpunkt
  • Kasuta AsyncOpenAI() asünkroonsete rakenduste jaoks
  • Konfigureeri aegumine ja korduskatsed vastavalt oma vajadustele
  • Struktureeri oma projekt .env faili ja tsentraliseeritud kliendiga