Wie man ein CLI-Tool mit der OpenAI-API erstellt
Wir bauen ein CLI-Tool, das auf die OpenAI-API zugreift, und ehrlich gesagt, es kann Ihnen helfen, Interaktionen auf eine Weise zu automatisieren, die Sie nie für möglich gehalten hätten.
Voraussetzungen
- Python 3.11+
- pip install openai
- Grundkenntnisse in der Python-Programmierung
- Ein OpenAI-Konto und API-Schlüssel
Schritt 1: Einrichten Ihrer Umgebung
Als Erstes müssen Sie das OpenAI-Python-Paket installieren. Dies ist das Kernpaket, das es Ihrem Python-Code ermöglicht, mit der API von OpenAI zu interagieren. Wenn Sie noch nie ein Paket in Python installiert haben, hier ist der Deal: Es wird von pip verwaltet. Wenn pip nicht installiert ist, leben Sie im Grunde genommen im Steinzeitalter.
pip install openaiSie werden wahrscheinlich auf Fehler stoßen wie „pip-Befehl nicht gefunden“. Wenn das passiert, überprüfen Sie Ihre Python-Installation und stellen Sie sicher, dass Python zu Ihrem Systempfad hinzugefügt wurde. Das Beheben dauert nur ein paar Minuten. Denken Sie daran, wenn Sie feststecken, können Sie gerne googeln; es gibt unzählige Tutorials zur Installation von Python und pip.
Schritt 2: Ihren OpenAI API-Schlüssel erhalten
Ihr API-Schlüssel ist wie der Schlüssel zu Ihrem Haus, nur dass dieses Haus coole KI-Dinge macht. Um mit den Diensten von OpenAI zu interagieren, benötigen Sie einen API-Schlüssel. Hier ist, wo Sie ihn bekommen:
- Melden Sie sich bei Ihrem OpenAI-Konto an.
- Navigieren Sie zum API-Bereich.
- Kopieren Sie Ihren API-Schlüssel von dort.
Denken Sie daran: Wenn Sie diesen Schlüssel hartcodiert in Ihrem CLI-Tool speichern, haben Sie das Spiel bereits verloren. Machen Sie das nicht. Bewahren Sie ihn sicher auf.
Schritt 3: Schreiben des Python-Codes
Jetzt lassen Sie uns ein einfaches CLI-Tool erstellen, das die OpenAI-API abfragt. Wir richten es so ein, dass es Benutzereingaben entgegennimmt, diese an OpenAI sendet und die Antwort ausgibt. Hier beginnt die Magie.
import openai
import os
# Laden Sie den API-Schlüssel aus der Umgebungsvariable
openai.api_key = os.getenv("OPENAI_API_KEY")
def query_openai(prompt):
response = openai.ChatCompletion.create(
model="gpt-3.5-turbo",
messages=[
{"role": "user", "content": prompt}
]
)
return response['choices'][0]['message']['content']
if __name__ == "__main__":
user_input = input("Was möchten Sie OpenAI fragen? ")
answer = query_openai(user_input)
print(answer)
Die Auswahl des Modells ist wichtig. Die Verwendung von „gpt-3.5-turbo“ ist für die meisten Zwecke eine sichere Wahl. Wenn Sie ein anderes Modell verwenden, können die Ergebnisse unterschiedlich ausfallen, einschließlich solcher, die nicht stimmig sind. Einfach gesagt, ich habe andere Modelle ausprobiert, die nonsense produziert haben. Halten Sie sich einfach an das Bewährte, es sei denn, Sie haben einen speziellen Grund, zu wechseln.
Schritt 4: Fehlerbehandlung
Wenn Sie beginnen, dieses Tool auszuführen, werden Sie wahrscheinlich auf einige Fehler stoßen. Ich habe in der Vergangenheit viele Fehler gemacht, die mich gelehrt haben, wie man effektiv Probleme behebt.
- Fehler: AuthenticationError – Wenn Sie einen Authentifizierungsfehler erhalten, ist wahrscheinlich Ihr API-Schlüssel falsch oder nicht gesetzt. Überprüfen Sie Ihre Umgebungsvariablen.
- Fehler: RateLimitError – Wenn Sie von OpenAI gedrosselt werden, bedeutet das, dass Sie die Nutzungslimits erreicht haben. Stellen Sie sicher, dass Sie einen Mechanismus zum erneuten Versuch implementieren und möglicherweise eine Drosselungslogik, um dies zu vermeiden.
- ServerError – Manchmal hat der Server einfach einen schlechten Tag. Wenn Sie auf einen Serverfehler stoßen, versuchen Sie die Anfrage nach kurzer Wartezeit erneut.
Die Stolpersteine
Hier ist das Ding: Es gibt Fallstricke, die in Tutorials selten besprochen werden. Basierend auf meinen Erfahrungen bin ich hier, um Ihnen einige Kopfschmerzen zu ersparen:
- Umgang mit API-Limits – Stellen Sie sicher, dass Sie die Limits Ihres OpenAI-Kontos verstehen. Wenn Sie diese überschreiten, kann Ihre App einfach ohne klare Nachricht ausfallen.
- Umgebungsmanagement – Wenn Sie keine virtuellen Umgebungen verwenden, könnten Ihre Abhängigkeiten in Konflikt stehen. Verwenden Sie
venv, um diesen Kopfweh zu vermeiden. - Input-Spezifikationen – OpenAI kann übermäßig lange Eingaben nicht effizient verarbeiten. Kürzen Sie Ihre Eingabeaufforderungen, wenn Sie seltsame Ausgaben erhalten.
- Sicherheitsbedenken – Stellen Sie sicher, dass Sie Ihre API-Schlüssel nicht im Code offenlegen. Verwenden Sie Umgebungsvariablen. Ich habe mich wegen dieses Problems wochenlang aus meinen eigenen Projekten ausgeschlossen.
Vollständiges Codebeispiel
| Dateiname | Beschreibung |
|---|---|
| cli_tool.py | Dies ist Ihr Hauptskript, das mit der OpenAI-API interagiert. |
| README.md | Dokumentation zur Ausführung und Nutzung Ihres Tools. |
| requirements.txt | Listet die Abhängigkeiten für Ihr Python-Projekt auf. |
# cli_tool.py
import openai
import os
# Laden Sie den API-Schlüssel aus der Umgebungsvariable
openai.api_key = os.getenv("OPENAI_API_KEY")
def query_openai(prompt):
response = openai.ChatCompletion.create(
model="gpt-3.5-turbo",
messages=[
{"role": "user", "content": prompt}
]
)
return response['choices'][0]['message']['content']
if __name__ == "__main__":
user_input = input("Was möchten Sie OpenAI fragen? ")
answer = query_openai(user_input)
print(answer)
# requirements.txt
openai
Was kommt als Nächstes
Verleihen Sie Ihrem CLI-Tool eine Persönlichkeit. Vielleicht implementieren Sie eine chatähnliche Schnittstelle, bei der Sie das Gespräch fortsetzen können, anstatt nur Einzelfragen zu stellen. Das macht es ansprechender und weniger wie eine grundlegende Frage- und Antwort-Sitzung.
FAQ
- Wie bekomme ich meinen API-Schlüssel? Melden Sie sich einfach bei Ihrem OpenAI-Konto an und navigieren Sie zu den API-Einstellungen, wo Sie Ihre Schlüssel generieren und verwalten können.
- Was ist, wenn ich keine Programmiererfahrung habe? Beginnen Sie mit einigen grundlegenden Python-Tutorials. Die Einstiegshürde ist nicht steil, aber Sie müssen die Grundlagen beherrschen.
- Kann ich dieses Tool ohne Internetverbindung ausführen? Nein, Ihr Tool kommuniziert über das Internet mit den Servern von OpenAI. Kein Internet, keine API.
Datenquellen
Letzte Aktualisierung am 29. März 2026. Daten stammen aus offiziellen Dokumenten und Community-Benchmarks.
🕒 Published: