Instalē Python SDK
Šajā lapā
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 openaivirtuā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
.envfailu un centralizētu klientu