Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Installation des Python-SDKs

Lektion 4 von 22 Aktualisiert am 2. November 2026 Entwickler
Auf dieser Seite
  1. Installation des Python-SDKs
  2. Voraussetzungen und Installation
  3. Ein Client für alle APIs
  4. Konfigurieren des Clients für Ihren Kontext
  5. Strukturieren Ihres Projekts
  6. Drei häufige Fehler
  7. Kernaussagen

Installation des Python-SDKs

Die openai-Python-Bibliothek ist die offizielle Bibliothek zur Interaktion mit der API. In dieser Lektion erfahren Sie, wie Sie das SDK installieren, und richten eine saubere Projektstruktur ein, die Sie im gesamten weiteren Kurs verwenden werden.

Voraussetzungen und Installation

Sie benötigen Python 3.10 oder neuer – das Minimum, das vom openai-SDK (Version 3.42.1, Stand 2. November 2026, laut PyPI) gefordert wird –, einen Paketmanager (pip oder uv) und den API-Schlüssel, den Sie in der vorherigen Lektion erhalten haben. Beginnen Sie damit, Ihren Interpreter zu bestätigen, da Entwicklungsmaschinen oft mehrere Versionen hosten:

python --version
# Python 3.12.4

Die Installation erfolgt mit einem einzigen Befehl: pip install openai oder uv pip install openai, falls Sie uv verwenden, was deutlich schneller ist. Gewöhnen Sie sich jedoch an, innerhalb einer virtuellen Umgebung zu arbeiten. Dies verhindert das häufige Szenario, dass Sie sechs Monate später feststellen, dass zwei Projekte inkompatible Versionen derselben Bibliothek erfordern.

# Erstellung einer virtuellen Umgebung
python -m venv .venv

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

# Aktivierung (Windows)
.venv\Scripts\activate

# Installation des SDKs
pip install openai

Zwei Begleiter tauchen in fast jedem Projekt auf und verdienen eine Installation neben dem SDK. Pydantic hilft dabei, Schemata für das strukturierte Ausgabeformat zu definieren, das Sie später sehen werden; python-dotenv lädt die .env-Datei in Umgebungsvariablen.

# Installation mit Unterstützung für Pydantic-Datentypen
pip install openai pydantic

# Installation von python-dotenv für Umgebungsvariablen
pip install openai python-dotenv

Schließlich überprüfen Sie, ob der Import funktioniert, und notieren Sie die installierte Version. Dies ist die erste Information, die Sie angeben sollten, wenn Sie einen Support-Ticket eröffnen.

import openai
print(f"OpenAI SDK version: {openai.__version__}")
# Ausgabe: OpenAI SDK version: 1.68.0 (oder neuer)

Ein Client für alle APIs

Das SDK dreht sich um einen einzigen Client-Objekt, das die gesamte Plattform über Untermodule bereitstellt. Sie müssen nichts Neues initialisieren, um von der Textgenerierung zu Embeddings oder Moderation zu wechseln.

from openai import OpenAI

client = OpenAI()

# Responses API (Text, Funktionsaufrufe, strukturierte Ausgabe)
client.responses.create(...)

# Chat Completions API (Legacy)
client.chat.completions.create(...)

# Embeddings
client.embeddings.create(...)

# Bilder
client.images.generate(...)

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

# Moderation
client.moderations.create(...)

Konfigurieren des Clients für Ihren Kontext

Die Standardwerte des SDKs eignen sich für Experimente, reichen aber für Webanwendungen nicht aus. Die Standardzeitüberschreitung beträgt zehn Minuten: In einer HTTP-API, die innerhalb weniger Sekunden antworten soll, bedeutet dies, dass eine hängende Anfrage einen Worker für viel zu lange bindet. Reduzieren Sie diese Zeit und erhöhen Sie die Anzahl der automatischen Wiederholungsversuche, die standardmäßig bei zwei liegt.

from openai import OpenAI

client = OpenAI(
    timeout=60.0,  # 60 Sekunden (Standard: 10 Minuten)
    max_retries=3,  # 3 Versuche bei Fehlern (Standard: 2)
)

Der Parameter base_url adressiert einen weiteren Bedarf: das Routing von Aufrufen durch einen Unternehmens-Proxy, der den ausgehenden Verkehr protokolliert, oder zu einem Dienst, der eine kompatible API bereitstellt.

# Nützlich für Unternehmens-Proxy oder kompatible APIs
client = OpenAI(
    base_url="https://your-proxy.company.com/v1"
)

Schließlich, wenn Ihre Anwendung auf asyncio angewiesen ist – FastAPI, aiohttp und dergleichen – verwenden Sie AsyncOpenAI. Der synchrone Client würde den Ereignisloop während der Generierung blockieren und die Vorteile von asynchronem Code zunichtemachen.

from openai import AsyncOpenAI

async_client = AsyncOpenAI()

# Verwendung mit 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())
# Ausgabe: Hello! How can I help you today?

Strukturieren Ihres Projekts

Adoptieren Sie eine Organisation, die die Client-Konfiguration von Anfang an vom Rest Ihres Codes isoliert. Dies verhindert, dass Sie Dutzende von OpenAI()-Aufrufen über Ihr Projekt verteilen, jeder mit eigenen Einstellungen.

my-project/
├── .env                  # API-Schlüssel (NIEMALS in Git committen)
├── .gitignore            # Enthält .env
├── requirements.txt      # Abhängigkeiten
├── src/
│   ├── __init__.py
│   ├── client.py         # Konfiguration des OpenAI-Clients
│   └── main.py           # Einstiegspunkt
└── tests/
    └── test_api.py

Die Datei src/client.py zentralisiert den Client-Fabrikator: An dem Tag, an dem Sie die Zeitüberschreitung ändern oder einen Proxy hinzufügen, müssen Sie nur noch einen Ort ändern.

from openai import OpenAI
from dotenv import load_dotenv

load_dotenv()

def get_client() -> OpenAI:
    """Gibt einen konfigurierten OpenAI-Client zurück."""
    return OpenAI(
        max_retries=3,
        timeout=30.0
    )

Und requirements.txt fixiert die minimalen erwarteten Versionen:

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

Drei häufige Fehler

Ein ModuleNotFoundError für openai signalisiert fast immer eine inaktive virtuelle Umgebung oder eine andere als diejenige, in der das Paket installiert wurde. Lokalisieren Sie den tatsächlich verwendeten Interpreter mit which python auf Linux und macOS oder where python auf Windows, und installieren Sie dann erneut mit pip install --upgrade openai. Ein AuthenticationError verweist auf die Umgebungsvariable: Geben Sie os.environ.get("OPENAI_API_KEY", "NOT DEFINED") aus, um Probleme auszuschließen – die .env-Datei wird nicht geladen, wenn load_dotenv() nicht vor der Initialisierung des Clients aufgerufen wurde. Schließlich weist ein Fehler bezüglich eines unbekannten Parameters in der Regel auf ein zu altes SDK für die Funktion hin, die Sie verwenden: pip install --upgrade openai löst dies.

Kernaussagen

  • Installieren Sie das SDK mit pip install openai innerhalb einer virtuellen Umgebung.
  • Der OpenAI()-Client ist der Einstiegspunkt für alle APIs.
  • Verwenden Sie AsyncOpenAI() für asynchrone Anwendungen.
  • Konfigurieren Sie die Zeitüberschreitung und Wiederholungsversuche basierend auf Ihren Anforderungen.
  • Strukturieren Sie Ihr Projekt mit einer .env-Datei und einem zentralisierten Client.