API & SDK. Der Bestellschalter und der Werkzeugkasten

Sobald jemand erklärt, wie eine KI in einem Produkt funktioniert, fallen zwei Buchstaben-Salate fast immer: API und SDK. Beide klingen technisch, beide bedeuten im Kern etwas sehr Bodenständiges. Wir machen das jetzt einmal langsam, mit zwei Alltagsbildern, die du dir merken kannst.

API, der Bestellschalter

Die Abkürzung API steht für Application Programming Interface, auf Deutsch etwa "Programmierschnittstelle". Das ist ein Wort, das auf dem Papier komplizierter aussieht, als es im Alltag ist.

Konkret im KI-Kontext: Firmen wie Anthropic, OpenAI oder Google betreiben riesige Rechenzentren, in denen ihre Modelle laufen. Diese Modelle sind so groß, dass du sie nicht auf deinem Laptop laufen lassen kannst. Stattdessen stellen die Firmen eine API bereit, also einen Bestellschalter im Internet, an den du deine Anfrage schickst.

Du schickst zum Beispiel "Schreib mir ein Gedicht über Hamburg" an eine bestimmte Web-Adresse. Auf der anderen Seite läuft das Modell, antwortet, und schickt dir den Text zurück. Du hast nie das Modell selbst angefasst. Du hast nur bestellt.

REST API und JSON. Format der Bestellung

In den allermeisten Fällen funktioniert die KI-API als sogenannte REST API. Das ist eine ganz bestimmte Art, wie Bestellungen über das Internet versendet werden, nach festen Regeln, mit fester Adresse, festen Befehlen wie "hole das" oder "schicke das".

Und das Format, in dem die Bestellung verpackt wird, heißt JSON, gesprochen wie "Jason". Das ist im Grunde nur eine bestimmte Schreibweise, mit der man strukturierte Daten aufschreibt: Schlüssel und Werte in geschweiften Klammern. Du musst die genaue Syntax nicht auswendig lernen, wichtig ist nur das Bild: JSON ist der Zettel, auf dem die Bestellung steht.

Der API-Key, dein Ausweis

Damit die API weiß, wer da bestellt, brauchst du einen API-Key. Das ist eine lange, geheime Zeichenkette, die du bekommst, wenn du dich bei dem Anbieter registrierst. Bei jeder Bestellung schickst du diesen Key mit.

SDK, der Werkzeugkasten

Jetzt zum zweiten Begriff. SDK steht für Software Development Kit. Wieder so ein Wort, das mehr Angst macht als nötig.

Konkret: Wenn du in Python oder JavaScript ein Programm schreiben willst, das mit der Anthropic-KI redet, könntest du theoretisch jedes Mal mühsam einen JSON-Bestellzettel zusammenbauen, ihn an die API-Adresse schicken, die Antwort entgegennehmen, das JSON wieder auspacken und Fehler abfangen. Das ist lästig.

Stattdessen installierst du das Anthropic SDK, eine fertige Bibliothek für deine Programmiersprache. Dann schreibst du einfach client.messages.create(...), und das SDK kümmert sich um den ganzen Bestellzettel-Kram im Hintergrund.

Wie sieht das aus?

Hier ein winziges Beispiel in Python, keine Sorge, du musst es nicht verstehen, nur einmal anschauen:

from anthropic import Anthropic

client = Anthropic(api_key="dein-key-hier")

antwort = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=200,
    messages=[{"role": "user", "content": "Schreib ein Gedicht über Hamburg."}]
)

print(antwort.content[0].text)

Fünf richtige Zeilen Code, und du hast eine fertige KI-Antwort. Ohne SDK wären das gut und gerne 30 Zeilen voller Verbindungs-Code, JSON-Bastelei und Fehlerbehandlung.

API vs. SDK, direkt nebeneinander

Wann nehme ich was?

Die Faustregel ist erfreulich kurz:

In der Praxis heißt das: Python- und JavaScript-Entwickler nehmen so gut wie immer das SDK. Wer in einer exotischeren Sprache wie Rust, Elixir oder Crystal arbeitet, baut sich oft eigene kleine API-Wrapper. Und wenn du nur mal kurz aus dem Terminal etwas testen willst, schickst du mit einem Werkzeug namens curl einfach direkt einen Bestellzettel an die API.

SDK ist die freundliche Hülle. API ist der eigentliche Schalter. Beide reden mit demselben Modell.

Was die API alles kann

Die KI-API ist nicht nur "Frage rein, Antwort raus". Über dieselbe Schnittstelle kannst du auch:

• Bilder mitschicken, und die KI sagt dir, was darauf zu sehen ist.
• Dokumente anhängen, z.B. eine PDF, über die die KI sprechen soll.
• Werkzeuge definieren, die die KI benutzen darf (mehr dazu im Kapitel über Agents).
• Strömungs-Antworten ("Streaming"). Wort für Wort, statt am Ende den ganzen Block.
• System-Anweisungen geben, etwa "Du bist ein höflicher Kundenservice-Assistent."

All das funktioniert sowohl direkt über die API als auch über das SDK, nur dass das SDK es eben angenehmer macht.

Und die Kosten?

Ein Punkt, den viele Anfänger übersehen: API-Nutzung kostet Geld. Du bezahlst pro Token, also pro Stückchen Text, das rein- und rausgeht. Ein paar Cent pro tausend Wörter, je nach Modell. Für ein einzelnes Hobby-Skript kaum spürbar, für eine produktive Anwendung mit tausenden Nutzern eine echte Kostenposition.

Deshalb gilt: erst denken, dann bestellen. Schickst du wirklich nötigen Kontext? Brauchst du das ganze 200.000-Wörter-Modell, oder reicht ein kleineres? Solche Fragen werden plötzlich relevant.