Software Development Kit (SDK)

Software Development Kit im Überblick

Ein SDK ist ein fertiges Paket, das dir die Arbeit mit einer API abnimmt. Statt selbst HTTP-Requests zu bauen, nutzt du einfache Funktionsaufrufe.

Warum SDKs nutzen?

• Authentifizierung, Fehlerbehandlung und Retry-Logik sind eingebaut
• Typdefinitionen für bessere IDE-Unterstützung
• Best Practices und Dokumentation inklusive

Ohne SDK (raw HTTP):

import requests
response = requests.post(
    "https://api.openai.com/v1/chat/completions",
    headers={"Authorization": "Bearer sk-..."},
    json={"model": "gpt-5", "messages": [{"role": "user", "content": "Hi"}]}
)

Mit SDK:

from openai import OpenAI
client = OpenAI()
response = client.chat.completions.create(
    model="gpt-5",
    messages=[{"role": "user", "content": "Hi"}]
)

Technisch betrachtet

Was ein gutes SDK bietet

• Typisierung: Autovervollständigung und Fehlerprüfung in der IDE
• Retry-Logik: Automatische Wiederholung bei transienten Fehlern
• Streaming: Einfache Nutzung von Server-Sent Events
• Error Handling: Spezifische Exception-Klassen statt generischer HTTP-Fehler
• Pagination: Automatisches Handling von paginierten Ergebnissen

Fehlerbehandlung mit SDK

from openai import OpenAI, RateLimitError, APITimeoutError

client = OpenAI()

try:
    response = client.chat.completions.create(
        model="gpt-5",
        messages=[{"role": "user", "content": "Hallo"}],
        timeout=30.0
    )
except RateLimitError:
    print("Rate Limit erreicht – warte und versuche erneut")
except APITimeoutError:
    print("Timeout – Anfrage zu lang")

Das SDK wirft spezifische Exceptions statt generischer HTTP-Fehler – das macht Fehlerbehandlung deutlich einfacher.

KI-SDK-Vergleich (2025)

Wann kein SDK?

Direkte HTTP-Calls sind sinnvoll wenn:

• Du eine Sprache nutzt für die kein offizielles SDK existiert
• Du minimale Abhängigkeiten willst (z. B. in Embedded-Systemen)
• Du das SDK-Verhalten genau verstehen und kontrollieren willst