Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Instalē Python SDK

Nodarbība 4 no 22 Atjaunota 2026. gada 2. novembris Programmētājs
Šajā lapā
  1. Instalē Python SDK
  2. Priekšnosacījumi un instalācija
  3. Viens klients, visi API
  4. Konfigurē klientu savam kontekstam
  5. Strukturē savu projektu
  6. Trīs biežākās kļūmes
  7. Galvenās atziņas

Instalē Python SDK

openai Python SDK ir oficiālā bibliotēka darbam ar API. Šajā nodarbībā tu veiksi instalāciju un izveidosi tīru projekta struktūru, ko izmantosi visa kursa garumā.

Priekšnosacījumi un instalācija

Tev ir nepieciešams Python 3.10 vai jaunāka versija – minimālā prasība openai SDK (versija 3.42.1, sākot no 2026. gada 2. novembra, pēc PyPI datiem), kā arī pakotņu pārvaldnieks (pip vai uv) un API atslēga, ko ieguvai iepriekšējā nodarbībā. Vispirms pārliecinies par savu interpretatoru, jo izstrādes datoros bieži vien ir instalētas vairākas versijas:

python --version
# Python 3.12.4

Instalācijai pietiek ar vienu komandu: pip install openai, vai uv pip install openai, ja izmanto uv, kas darbojas ievērojami ātrāk. Tomēr pieradini sevi strādāt virtuālajā vidē. Tas novērš situācijas, kad pēc sešiem mēnešiem atklāj, ka diviem projektiem ir nepieciešamas nesavietojamas vienas un tās pašas bibliotēkas versijas.

# Izveido virtuālo vidi
python -m venv .venv

# Aktivizē (Linux/macOS)
source .venv/bin/activate

# Aktivizē (Windows)
.venv\Scripts\activate

# Instalē SDK
pip install openai

Gandrīz katrā projektā parādās divi papildu rīki, kurus vērts instalēt līdztekus SDK. Pydantic palīdz definēt shēmas strukturētai izvadei, ko aplūkosim vēlāk; python-dotenv ielādē .env failu vides mainīgajos.

# Instalē ar atbalstu Pydantic datu klasēm
pip install openai pydantic

# Instalē ar python-dotenv vides mainīgajiem
pip install openai python-dotenv

Visbeidzot, pārbaudi, vai imports darbojas, un pieraksti instalēto versiju. Šī ir pirmā informācija, kas jāsniedz, ja atver atbalsta pieprasījumu.

import openai
print(f"OpenAI SDK version: {openai.__version__}")
# Output: OpenAI SDK version: 1.68.0 (or newer)

Viens klients, visi API

SDK balstās uz vienu klienta objektu, kas caur apakšmoduļiem nodrošina piekļuvi visai platformai. Tev nav jāizveido jauni eksemplāri, lai pārietu no teksta ģenerēšanas uz iegulšanu (embeddings) vai moderāciju.

from openai import OpenAI

client = OpenAI()

# Responses API (teksts, funkciju izsaukumi, strukturēta izvade)
client.responses.create(...)

# Chat Completions API (vecākā versija)
client.chat.completions.create(...)

# Iegulšanas (Embeddings)
client.embeddings.create(...)

# Attēli
client.images.generate(...)

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

# Moderācija
client.moderations.create(...)

Konfigurē klientu savam kontekstam

SDK noklusējuma iestatījumi der eksperimentiem, bet nepietiek tīmekļa lietotnēm. Noklusējuma noilgums ir desmit minūtes: HTTP API, kam paredzēts atbildēt dažu sekunžu laikā, tas nozīmē, ka iestrēdzis pieprasījums pārāk ilgi notur darbinieku. Samazini šo laiku un palielini automātisko mēģinājumu skaitu, kas pēc noklusējuma ir divi.

from openai import OpenAI

client = OpenAI(
    timeout=60.0,  # 60 sekundes (noklusējums: 10 minūtes)
    max_retries=3,  # 3 mēģinājumi kļūdas gadījumā (noklusējums: 2)
)

Parametrs base_url risina citas vajadzības: piemēram, maršrutē pieprasījumus caur korporatīvo starpniekserveri, kas reģistrē izejošo satiksmi, vai uz servisu, kas piedāvā saderīgu API.

# Noderīgi korporatīvajiem starpniekserveriem vai saderīgiem API
client = OpenAI(
    base_url="https://your-proxy.company.com/v1"
)

Visbeidzot, ja tava lietotne paļaujas uz asyncio – FastAPI, aiohttp un tamlīdzīgi – izmanto AsyncOpenAI. Sinhronais klients bloķētu notikumu cilpu ģenerēšanas laikā, anulējot asinhronā koda priekšrocības.

from openai import AsyncOpenAI

async_client = AsyncOpenAI()

# Lietošana ar 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?

Strukturē savu projektu

Pieņem organizāciju, kas no paša sākuma atdala klienta konfigurāciju no pārējā koda. Tas novērš situāciju, kad visā projektā ir izkaisīti desmitiem OpenAI() izsaukumu, katram ar saviem iestatījumiem.

my-project/
├── .env                  # API atslēga (NEKAD neievieto git)
├── .gitignore            # Ietver .env
├── requirements.txt      # Atkarības
├── src/
│   ├── __init__.py
│   ├── client.py         # OpenAI klienta konfigurācija
│   └── main.py           # Ieejas punkts
└── tests/
    └── test_api.py

Fails src/client.py centralizē klienta rūpnīcu: dienā, kad mainīsi noilgumu vai pievienosi starpniekserveri, tev būs jāveic izmaiņas tikai vienā vietā.

from openai import OpenAI
from dotenv import load_dotenv

load_dotenv()

def get_client() -> OpenAI:
    """Atgriež konfigurētu OpenAI klientu."""
    return OpenAI(
        max_retries=3,
        timeout=30.0
    )

Un requirements.txt fiksē minimālās paredzamās versijas:

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

Trīs biežākās kļūmes

ModuleNotFoundError attiecībā uz openai gandrīz vienmēr norāda uz neaktīvu virtuālo vidi vai to, ka tā atšķiras no vides, kurā pakotne tika instalēta. Atrodi faktiski izmantoto interpretatoru ar which python (Linux un macOS) vai where python (Windows), pēc tam reinstalē ar pip install --upgrade openai. AuthenticationError norāda uz problēmu ar vides mainīgo: izdrukā os.environ.get("OPENAI_API_KEY", "NOT DEFINED"), lai izslēgtu šaubas – .env fails netiek ielādēts, ja load_dotenv() nav izsaukts pirms klienta izveides. Visbeidzot, kļūda par nezināmu parametru parasti liecina, ka SDK ir pārāk veca funkcijai, ko izmanto: to atrisina ar pip install --upgrade openai.

Galvenās atziņas

  • Instalē SDK ar pip install openai virtuālajā vidē
  • OpenAI() klients ir ieejas punkts visiem API
  • Asinhronām lietotnēm izmanto AsyncOpenAI()
  • Konfigurē noilgumu un mēģinājumu skaitu atbilstoši savām vajadzībām
  • Strukturē projektu ar .env failu un centralizētu klientu