Ihr erster API-Call: Python und die Grundlagen

Fünf Zeilen Code kkDie durchschnittliche Zahl neuer Nutzer, die jeder bestehende Nutzer über Empfehlungen generiert. Über 1,0 verstärkt sich das Wachstum selbst und wird exponentiell.Vollständige Definition ansehen →önnen eine Frage an ein KI-Modell schicken, das irgendwo in einem Rechenzentrum läuft, und die Antwort in Ihrem Terminal zurückliefern. Keine Website, keine Chatbox, nur Ihr Code, der direkt mit dem Modell spricht. Das ist ein API-Call, und am Ende dieser Lektion haben Sie einen gemacht.

Was ein "APIAPIApplication Programming Interface: eine standardisierte Schnittstelle, über die Anwendungen kommunizieren und Daten austauschen, ohne die interne Funktionsweise der jeweils anderen zu kennen.Vollständige Definition ansehen →-Call" tatsächlich bedeutet

Eine API (Application Programming Interface) ist eine Tür, die eine Software öffnet, damit andere Software mit ihr sprechen kann. Wenn Sie ChatGPT im Browser nutzen, tippen Sie. Mit einer API tippt und liest stattdessen Ihr *Code*.

Stellen Sie es sich wie eine Bestellung im Restaurant vor:

• Sie (Ihr Code) geben eine Bestellung auf: "eine Nachricht für die KI."
• Die Küche (die Server des KI-Anbieters) erledigt die Arbeit.
• Ein Kellner bringt das Gericht zurück: "die Antwort der KI."

Sie sehen die Küche nie. Sie müssen nur wissen, wie man bestellt und was zurückkommt.

Ein SDK (Software Development Kit) ist ein kleines Toolkit, das der Anbieter bereitstellt, damit Ihr Code diese Bestellung ohne Umstände aufgeben kann. Statt rohe Web-Requests zu schreiben, rufen Sie eine saubere Funktion auf. Wir nutzen unten eines davon.

Was Sie vorher brauchen

Drei Dinge:

1. Python installiert. Python ist eine Programmiersprache, die für ihre Lesbarkeit bekannt ist. Falls Sie es nicht haben, führt Sie die offizielle Python-Downloadseite durch die Installation.
2. Einen API-Key. Das ist ein geheimes Passwort, das dem Anbieter sagt: "diese Anfrage kommt von mir, belaste mein Konto." Sie erstellen ihn im Dashboard Ihres Anbieters (OpenAI, Anthropic oder Google).
3. Das SDK installiert. Ein Befehl genügt.

Ein Wort zu den Kosten: API-Calls sind nicht kostenlos, aber zum Lernen günstig. Ein paar hundert Testnachrichten kosten meist unter einem Dollar. Neue Accounts enthalten oft ein kleines Gratisguthaben.

Das SDK installieren

Öffnen Sie Ihr Terminal (die textbasierte Steuerkonsole Ihres Computers) und führen Sie einen dieser Befehle aus:

# For Anthropic's Claude
pip install anthropic

# For OpenAI's ChatGPT models
pip install openai

# For Google's Gemini
pip install google-genai

pip ist der Installer von Python. ErErDas Verhältnis von Interaktionen (Likes, Kommentare, Shares) zur Reichweite eines Inhalts. Zeigt, wie stark die Zielgruppe reagiert, gemessen an der Zahl der Personen, die den Inhalt gesehen haben.Vollständige Definition ansehen → holt das Toolkit aus dem Internet und richtet es ein. Das machen Sie nur einmal.

Ihr erster Call, Zeile für Zeile

Hier ist ein vollständiges, lauffähiges Programm mit Claude. Speichern Sie es als first_call.py.

import anthropic

client = anthropic.Anthropic(api_key="YOUR_KEY_HERE")

response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=200,
    messages=[
        {"role": "user", "content": "Explain what an API is in one sentence."}
    ],
)

print(response.content[0].text)

Jetzt lesen wir jede Zeile.

import anthropic

Das lädt das Toolkit, das Sie installiert haben. "Import" heißt: "bring dieses Werkzeug in mein Programm, damit ich es nutzen kann."

client = anthropic.Anthropic(api_key="YOUR_KEY_HERE")

Das richtet Ihre Verbindung zum Anbieter ein. client ist nur ein Name, den wir dafür gewählt haben. Der api_key ist Ihr geheimes Passwort. Fügen Sie Ihren echten Key zwischen den Anführungszeichen ein.

response = client.messages.create(

Das ist die eigentliche Bestellung. Sie sagen dem Client: "erstelle einen neuen Nachrichtenaustausch." Alles in den Klammern sind die Details Ihrer Bestellung. Die Antwort wird in response gespeichert.

model="claude-sonnet-4-5"

Welches KI-Modell antworten soll. Anbieter bieten mehrere an, die Geschwindigkeit gegen Leistung abwägen. Sonnet ist 2026 eine starke, ausgewogene Wahl.

max_tokens=200

Ein TokenTokenEin Token ist die grundlegende Texteinheit, die Sprachmodelle verarbeiten, oft ein Wortfragment, ein ganzes Wort oder ein Satzzeichen und nicht ein einzelnes Zeichen.Vollständige Definition ansehen → ist ein Textstück, ungefähr drei Viertel eines Wortes. Das begrenzt, wie lang die Antwort werden darf, damit sie nicht endlos ausschweift (und Ihre Rechnung hochtreibt). 200 Token sind ein kurzer Absatz.

messages=[ ... ]

Die Konversation selbst. Jede Nachricht hat eine role und content. Hier ist die Rolle "user" (das sind Sie), und der Content ist Ihre eigentliche Frage.

print(response.content[0].text)

Die Antwort kommt in eine Struktur verpackt zurück. Diese Zeile holt den reinen Text heraus und gibt ihn auf dem Bildschirm aus. content[0] heißt "das erste Element der Response", und .text heißt "gib mir die Wörter".

Führen Sie es aus dem Terminal aus:

python first_call.py

Sie sollten etwa Folgendes sehen: *"Eine API ist ein Satz von Regeln, der es einem Softwareprogramm erlaubt, Dienste oder Daten von einem anderen anzufordern."*

Das war's. Sie haben gerade per Code mit einem KI-Modell gesprochen.

Dieselbe Idee, anderer Anbieter

Die drei großen Anbieter funktionieren fast identisch. Hier die OpenAI-Variante, damit Sie sehen, wie wenig sich ändert:

from openai import OpenAI

client = OpenAI(api_key="YOUR_KEY_HERE")

response = client.responses.create(
    model="gpt-5",
    input="Explain what an API is in one sentence."
)

print(response.output_text)

Gleiche Form: Client aufsetzen, Nachricht senden, Antwort ausgeben. Wenn Sie einen verstanden haben, verstehen Sie alle. Googles Gemini-SDK folgt mit google-genai demselben Muster.

Halten Sie Ihren Key geheim

Fügen Sie Ihren API-Key nie an einem öffentlichen Ort ein: nicht in ein GitHub-Repository, nicht in ein geteiltes Dokument, nicht in einen Screenshot. Wer Ihren Key hat, kann Ihr Geld ausgeben.

Die saubere Gewohnheit ist, den Key in einer Umgebungsvariable zu speichern (eine Einstellung, die Ihr Computer außerhalb Ihres Codes hält). Ihr Code liest ihn dann aus, ohne dass der Key je in der Datei auftaucht:

import os
import anthropic

client = anthropic.Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])

os.environ["ANTHROPIC_API_KEY"] heißt "suche den Wert, den ich unter diesem Namen gespeichert habe". Sie setzen diesen Wert einmal im Terminal oder in den Systemeinstellungen, und Ihr Code bleibt sauber. Für Ihren allerersten Test können Sie den Key ruhig direkt einfügen, wechseln Sie aber zu dieser Methode, bevor Sie etwas teilen.

Wie man ein kleines KI-Projekt strukturiert

Sobald Ihr erster Call funktioniert, verschiebt sich die Haltung von "ich habe eine Nachricht geschickt" zu "ich baue etwas". Ein paar Prinzipien halten Anfänger aus Schwierigkeiten heraus.

Starten Sie mit einem funktionierenden Call, dann ändern Sie eine Sache

Bringen Sie das Basisskript zum Laufen, bevor Sie etwas hinzufügen. Dann ändern Sie eine Sache nach der anderen: ein längerer Prompt, ein anderes Modell, ein größeres max_tokens. Wenn etwas kaputtgeht, wissen Sie genau, woran es lag.

Legen Sie Ihren Prompt in eine Variable

Wenn Ihr Prompt wächst, ziehen Sie ihn heraus, damit er leicht zu bearbeiten ist:

prompt = """
You are a helpful assistant.
Summarize the following review in one sentence,
then rate the sentiment from 1 to 5.

Review: The coffee was great but the wait was 25 minutes.
"""

response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=200,
    messages=[{"role": "user", "content": prompt}],
)

print(response.content[0].text)

Hier werden API-Calls nützlich. Sie können jetzt hunderte Reviews einspeisen, indem Sie über sie loopen, etwas, das Sie im Chatfenster von Hand nie schaffen würden.

Fügen Sie eine "System"-Anweisung für konsistentes Verhalten hinzu

Ein System-Prompt legt die Rolle und die Regeln der KI für die gesamte Konversation fest. Er hält jede Antwort on-brand:

response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=200,
    system="You are a concise assistant. Always answer in under 30 words.",
    messages=[{"role": "user", "content": "What is an API?"}],
)

Beachten Sie, dass das Feld system getrennt von messages steht. Der System-Prompt ist Ihre dauerhafte Anweisung; die messages sind die laufende Konversation.

Rechnen Sie damit, dass etwas kaputtgeht, und lesen Sie den Fehler

Fehler sind normal. Die zwei häufigsten für Anfänger:

• Authentication error: Ihr Key ist falsch, fehlt oder hat zusätzliche Leerzeichen. Prüfen Sie ihn erneut.
• Rate limit error: Sie haben zu viele Anfragen zu schnell geschickt. Warten Sie einen Moment und versuchen Sie es erneut.

Die Fehlermeldung sagt Ihnen fast immer, welcher von beiden es ist. Lesen Sie sie in Ruhe, bevor Sie Code ändern.

Schauen Sie in die offiziellen Docs, nicht in zufällige Foren

Anbieter-Docs werden aktuell gehalten und haben Copy-Paste-Beispiele für jedes Modell. Der API getting-started guide von Anthropic ist eine saubere Referenz. Setzen Sie ein Lesezeichen auf das Pendant Ihres Anbieters.

Warum das zählt

Das Chatfenster ist super für einmalige Fragen. Die API ist für *wiederholbare Arbeit*: 500 Support-Tickets zusammenfassen, eine Tabelle taggen, personalisierte E-Mails entwerfen, ein kleines Tool bauen, das ein Kollege nutzen kann. In dem Moment, in dem Sie das Modell aus dem Code aufrufen können, hört die KI auf, eine Website zu sein, die Sie besuchen, und wird zu einem Baustein, den Sie kontrollieren.

Key Takeaways

• Ein API-Call ist Ihr Code, der bei der KI bestellt: Sie senden eine Nachricht, die Server des Anbieters erledigen die Arbeit, Sie bekommen eine Antwort zurück. Das SDK ist das Toolkit, das die Bestellung einfach macht.
• Fünf Zeilen reichen zum Start: SDK importieren, Client mit Ihrem Key erstellen, Nachricht senden, Antwort ausgeben. Lassen Sie es laufen, bevor Sie etwas hinzufügen.
• Schützen Sie Ihren API-Key wie ein Passwort. Verschieben Sie ihn in eine Umgebungsvariable, bevor Sie Code teilen, damit er nie in einer Datei auftaucht.
• Ändern Sie eine Sache nach der anderen. Ziehen Sie Ihren Prompt in eine Variable, fügen Sie eine System-Anweisung für konsistentes Verhalten hinzu und lesen Sie Fehlermeldungen sorgfältig, wenn etwas schiefgeht.
• Greifen Sie zur API, wenn Sie wiederholbare Arbeit haben, etwa viele Elemente auf einmal zu verarbeiten, was das Chatfenster für Sie nicht leisten kann.