Zum Hauptinhalt springen
Die CometAPI CLI ist ein offizielles Befehlszeilentool für die Interaktion mit der CometAPI-Plattform. Sie unterstützt Multi-Model-Chat (Streaming und REPL), Modellsuche, Kontostands- und Nutzungsabfragen, das Durchsuchen von Protokollen sowie die Kontoverwaltung — alles direkt im Terminal. Beginnen Sie auf der PyPI-Paketseite, wenn Sie den aktuellen Installationsbefehl, Paketmetadaten und die Release-Version an einem Ort sehen möchten.
Die CometAPI CLI befindet sich in der beta-Phase. Rechnen Sie mit kleineren Änderungen an Befehlen und der UX, während sich die CLI-Oberfläche stabilisiert.

​
Funktionen

  • Multi-Model-Chat mit Streaming und interaktivem REPL
  • Modellsuche und -auflistung
  • Kontostand und Nutzungsstatistiken
  • Durchsuchen von Nutzungsprotokollen mit Filtern und CSV-Export
  • Protokolle asynchroner Aufgaben (Suno, Midjourney, Kling und andere)
  • Ausgabe in mehreren Formaten: Tabelle, JSON, YAML, CSV, Markdown
  • TOML-basierte Konfiguration mit Einrichtungsassistent
  • Shell-Completion für Bash, Zsh und Fish
  • Agentenfreundliches Design mit strukturierter JSON-Ausgabe und deterministischen Exit-Codes

​
Voraussetzungen

​
Installation

Verwenden Sie die PyPI-Paketseite als primäre Installationsreferenz und wählen Sie dann eine der folgenden Methoden, um die CLI zu installieren: 
pip install cometapi-cli
Überprüfen Sie die Installation: 
cometapi --version

​
Schnellstart

1

Führen Sie den Einrichtungsassistenten aus

Der interaktive Assistent speichert Ihren API key und das optionale access token in einer lokalen Konfigurationsdatei:
cometapi init
Der Assistent fragt nach:
2

Mit einem Modell chatten

Senden Sie eine einzelne Nachricht mit Streaming-Ausgabe:
cometapi chat "Explain quantum computing in one sentence"
Überschreiben Sie das Standardmodell:
cometapi chat "Hello!" --model claude-sonnet-4-6
3

Verfügbare Modelle suchen

Listen Sie Modelle auf, die zu einem Schlüsselwort passen:
cometapi models --search gemini --limit 10
4

Ihren Kontostand prüfen

Zeigen Sie Ihren Kontostand an:
cometapi balance
Zeigen Sie die aktuelle Abrechnungsansicht des API key an:
cometapi balance --source key
5

Diagnose ausführen

Überprüfen Sie, ob die CLI eine Verbindung zu CometAPI herstellen kann:
cometapi doctor

​
Interaktive Chat-Sitzung

Führen Sie cometapi chat ohne Argumente aus, um das REPL für mehrturnige Chats zu öffnen: 
cometapi chat
REPL-Befehle:
CommandBeschreibung
/modelDas aktive Modell wechseln
/systemDen System-Prompt festlegen oder ändern
/clearDen Gesprächsverlauf löschen
/historyDen Gesprächsverlauf anzeigen
/saveDas Gespräch in einer Datei speichern
/tokensDie Token-Nutzung für die Sitzung anzeigen
/helpAlle REPL-Befehle auflisten
/exitDas REPL beenden

​
Agent-Integration

Die CLI ist für die Verwendung durch AI-Coding-Agenten und Automatisierungsskripte konzipiert:
  • Alle Datenbefehle unterstützen --json für strukturierte, maschinenlesbare Ausgabe
  • Deterministische Exit-Codes: 0 (Erfolg), 64 (Konfiguration fehlt), 77 (Authentifizierungsfehler), 69 (Dienst nicht verfügbar)
  • Fehler gehen an stderr, Daten gehen an stdout
  • Siehe die vollständige Befehlsreferenz für befehlsspezifische Optionen