SDK (Software Development Kit)

Einfach erklärt

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"}]
)

Technischer Deep Dive

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)

SDK	Sprachen	Besonderheit
OpenAI	Python, Node.js, Go, Java	Streaming, Assistants API, Batch
Anthropic	Python, Node.js	Tool Use, Vision, sehr gute Docs
Google AI	Python, Node.js	Gemini, Multimodal, gratis Tier
LangChain	Python, JS	Abstraktion über alle Anbieter
Vercel AI SDK	TypeScript	React-Integration, Streaming UI

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