Sofortantwort
SDK einfach erklärt
Paket zur Unterstützung der API-Integration in Anwendungen.
- Kurz gesagt
- Fertige Code-Bibliotheken, die den Zugriff auf eine API vereinfachen
- Typischer Einsatz
- KI-Integration, Cloud-Services, Mobile Entwicklung
- Wichtig zu wissen
- Verfügbar für verschiedene Programmiersprachen (Python, JavaScript, Go, etc.)
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
Beide Beispiele nutzen die Responses API. Hinterlege den API-Schlüssel in OPENAI_API_KEY und setze OPENAI_MODEL auf die ID eines für dein Projekt verfügbaren Responses-Modells.
Direkter HTTP-Aufruf
import os
import requests
response = requests.post(
"https://api.openai.com/v1/responses",
headers={"Authorization": f"Bearer {os.environ['OPENAI_API_KEY']}"},
json={"model": os.environ["OPENAI_MODEL"], "input": "Hallo"},
timeout=30,
)
response.raise_for_status()
print(response.json()["output"])Aufruf mit dem Python-SDK
import os
from openai import OpenAI
client = OpenAI()
response = client.responses.create(
model=os.environ["OPENAI_MODEL"],
input="Hallo",
)
print(response.output_text)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
import os
from openai import OpenAI, RateLimitError, APITimeoutError
client = OpenAI()
try:
response = client.responses.create(
model=os.environ["OPENAI_MODEL"],
input="Hallo",
timeout=30.0,
)
print(response.output_text)
except RateLimitError:
print("Anfragelimit erreicht. Prüfe Kontingent und Wartezeit.")
except APITimeoutError:
print("Zeitlimit der Anfrage überschritten.")Das SDK wirft spezifische Exceptions statt generischer HTTP-Fehler – das macht Fehlerbehandlung deutlich einfacher.
SDKs und Frameworks für KI-Anwendungen
Ein Anbieter-SDK verbindet deine Anwendung direkt mit der jeweiligen API. Bei OpenAI stellt das API-SDK den Zugriff auf die Responses API bereit. Das separate Agents SDK unterstützt die Koordination von Werkzeugen und die Protokollierung der Abläufe. Frameworks wie LangChain bieten Integrationen für mehrere Anbieter. Prüfe bei der Auswahl, ob die benötigten Modellfunktionen in der konkreten Integration verfügbar sind.
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
