Ihr erster API-Call: Python und die Grundlagen

# Ihr erster APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen →-Call: Python und die Grundlagen

Fünf Zeilen Code kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen eine Frage an ein KI-Modell in irgendeinem Rechenzentrum senden und eine Antwort in Ihrem Terminal zurückbekommen. Keine Website, keine Chatbox, nur Ihr Code, der direkt mit dem Modell spricht. Das ist ein APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen →-Call, und am Ende dieser Lektion haben Sie einen gemacht.

Was „APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen →-Call“ tatsächlich bedeutet

Eine APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen → (Application Programming InterfaceApplication Programming InterfaceApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen →) ist eine Tür, die eine Software öffnet, damit andere Software mit ihr sprechen kann. Wenn Sie ChatGPT im Browser nutzen, sind Sie derjenige, der tippt. Mit einer APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen → tippt und liest stattdessen *Ihr Code*.

Stellen Sie sich das wie eine Bestellung im Restaurant vor:

• Sie (Ihr Code) geben eine Bestellung ab: „eine Nachricht für die KI.“
• Die KKThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →üche (die Server des KI-Anbieters) macht die Arbeit.
• Ein Kellner bringt das Gericht zurück: „die Antwort der KI.“

Sie sehen die KKThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →üche nie. Sie müssen nur wissen, wie man bestellt und was zurückkommt.

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

Was Sie zuerst 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: „dieser Request kommt von mir, rechne es meinem Konto zu.“ Sie erstellen ihn im Dashboard Ihres Anbieters (OpenAI, Anthropic oder Google).

3. Das SDK installiert. Ein Befehl genügt.

Ein Wort zu den Kosten: APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen →-Calls sind nicht kostenlos, aber zum Lernen günstig. Ein paar hundert Testnachrichten kosten meist unter einem Dollar. Neue Konten 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:

# Für Anthropics Claude
pip install anthropic

# Für OpenAIs ChatGPT-Modelle
pip install openai

# Für Googles Gemini
pip install google-genai

pip ist Pythons Installer. ErErThe ratio of interactions (likes, comments, shares) to reach for a given piece of content, used to gauge how well audiences respond relative to how many people saw it.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, ausführbares 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 gewählt haben. Der api_key ist Ihr geheimes Passwort. Fügen Sie Ihren echten Key zwischen die 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 haben mehrere im Angebot, die Geschwindigkeit gegen Leistung abwägen. Sonnet ist 2026 eine starke, ausgewogene Wahl.

`max_tokens=200`

Ein TokenTokenA token is the basic unit of text that language models process, often a word fragment, whole word, or punctuation mark rather than a single character.Vollständige Definition ansehen → ist ein Textbaustein, etwa drei Viertel eines Wortes. Das begrenzt die Länge der Antwort, damit sie nicht endlos ausschweift (und Ihre Rechnung hochtreibt). 200 TokensTokensA token is the basic unit of text that language models process, often a word fragment, whole word, or punctuation mark rather than a single character.Vollständige Definition ansehen → sind ein kurzer Absatz.

`messages=[ ... ]`

Das Gespräch 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 eingepackt zurück. Diese Zeile holt den reinen Text heraus und gibt ihn auf Ihrem Bildschirm aus. content[0] heißt „das erste Element der Antwort“, und .text heißt „gib mir die Wörter“.

Führen Sie es im Terminal aus:

python first_call.py

Sie sollten etwas sehen wie: *„Eine APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen → ist ein Regelwerk, das es einem Softwareprogramm erlaubt, Dienste oder Daten von einem anderen anzufordern.“*

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

Dieselbe Idee, anderer Anbieter

Die großen drei Anbieter funktionieren fast identisch. Hier die OpenAI-Version, 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 einrichten, Nachricht senden, Antwort ausgeben. Wenn Sie einen verstehen, verstehen Sie alle. Googles Gemini-SDK folgt mit google-genai demselben Muster.

Halten Sie Ihren Key geheim

Fügen Sie Ihren APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen →-Key nie an einer öffentlichen Stelle 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, 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 kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen Sie den Key ruhig direkt einfügen, aber wechseln Sie 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 gesendet“ zu „ich baue etwas“. Ein paar Prinzipien halten Anfänger aus dem Schlamassel.

Beginnen Sie mit einem funktionierenden Call und ändern Sie dann eine Sache

Bringen Sie das Basisskript zum Laufen, bevor Sie etwas hinzufügen. Nehmen Sie dann eine Änderung auf einmal vor: ein längerer Prompt, ein anderes Modell, ein höheres 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 ererThe ratio of interactions (likes, comments, shares) to reach for a given piece of content, used to gauge how well audiences respond relative to how many people saw it.Vollständige Definition ansehen → 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 APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen →-Calls nützlich. Sie kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen nun hunderte Reviews einspeisen, indem Sie in einer Schleife darüber laufen, etwas, das Sie im Chatfenster nie von Hand 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 das ganze Gespräch fest. ErErThe ratio of interactions (likes, comments, shares) to reach for a given piece of content, used to gauge how well audiences respond relative to how many people saw it.Vollständige Definition ansehen → 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 von messages getrennt ist. Der System-Prompt ist Ihre Dauer-Anweisung; die messages sind das laufende Gespräch.

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 Requests zu schnell gesendet. Warten Sie einen Moment und versuchen Sie es erneut.

Die Fehlermeldung sagt fast immer, um welchen es sich handelt. Lesen Sie sie langsam, bevor Sie Code ändern.

Schauen Sie in die offizielle Doku, nicht in irgendwelche Foren

Anbieter-Dokus werden aktuell gehalten und haben Copy-Paste-Beispiele für jedes Modell. Anthropics API getting-started guide ist eine klare Referenz. Setzen Sie das Pendant Ihres Anbieters als Bookmark.

Warum das wichtig ist

Das Chatfenster ist gut für einzelne Fragen. Die APIAPIApplication Programming Interface: a standardised interface that lets applications communicate and exchange data without knowing each other's internal workings.Vollständige Definition ansehen → ist für *wiederholbare Arbeit*: 500 Support-Tickets zusammenfassen, eine Tabelle taggen, personalisierte E-Mails entwerfen, ein kleines Tool bauen, das eine Kollegin nutzen kann. In dem Moment, in dem Sie das Modell aus Code aufrufen kkThe average number of new users each existing user generates through referrals. Above 1.0, growth compounds on itself and becomes exponential.Vollständige Definition ansehen →önnen, ist die KI keine Website mehr, die Sie besuchen, sondern ein 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 machen die Arbeit, Sie bekommen eine Antwort zurück. Das SDK ist das Toolkit, das das Bestellen einfach macht.
• Fünf Zeilen genügen zum Start: SDK importieren, Client mit Ihrem Key erstellen, Nachricht senden, Antwort ausgeben. Führen Sie es aus, 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 ererThe ratio of interactions (likes, comments, shares) to reach for a given piece of content, used to gauge how well audiences respond relative to how many people saw it.Vollständige Definition ansehen → nie in einer Datei auftaucht.
• Ändern Sie eine Sache auf einmal. Ziehen Sie Ihren Prompt in eine Variable, fügen Sie eine System-Anweisung für konsistentes Verhalten hinzu und lesen Sie Fehlermeldungen genau, wenn etwas schiefgeht.
• Greifen Sie zur API, wenn Sie wiederholbare Arbeit haben, etwa viele Elemente auf einmal verarbeiten, was das Chatfenster nicht für Sie leisten kann.