Befehlsreferenz

Befehlsübersicht

Command	Description	Auth
`chat [MESSAGE]`	Eine Nachricht senden oder interaktive REPL starten	API key
`models`	Verfügbare Modelle auflisten und durchsuchen	API key
`balance`	Kontostand anzeigen	API key (or access token)
`account`	Kontoprofil anzeigen	Access token
`stats`	Nutzungsstatistiken anzeigen	Access token
`tokens`	Ihre API-Schlüssel auflisten und durchsuchen	Access token
`logs`	Nutzungsprotokolle mit Filtern durchsuchen	Access token
`tasks`	Async-Task-Protokolle anzeigen	Access token
`init`	Interaktiver Einrichtungsassistent	—
`doctor`	Diagnose- und Zustandsprüfungen ausführen	API key
`config`	CLI-Konfiguration verwalten	—
`repl`	Interaktive Befehlsshell starten	API key

Befehle, die mit Access token markiert sind, erfordern die Umgebungsvariable COMETAPI_ACCESS_TOKEN oder den Konfigurationsschlüssel access_token. Siehe den Konfigurationsleitfaden für Details.

Chat

Eine einzelne Nachricht senden oder die interaktive REPL mit mehreren Turns starten.

# Single message (streaming by default)
cometapi chat "Explain quantum computing in one sentence"

# Override model and add a system prompt
cometapi chat "Summarize this" --model claude-sonnet-4-6 --system "Be concise"

# Disable streaming
cometapi chat "Hello" --no-stream

# JSON output (full API response)
cometapi chat "Hello" --json

# Interactive REPL (omit message)
cometapi chat

Option	Short	Description
`--model`	`-m`	Zu verwendendes Modell (Standard: aus der Konfiguration)
`--system`	`-s`	System Prompt
`--temperature`	`-t`	Sampling-Temperatur (0.0–2.0)
`--max-tokens`		Maximale Tokens in der Antwort
`--stream/--no-stream`		Streaming aktivieren oder deaktivieren (Standard: stream)
`--format`	`-f`	Ausgabeformat
`--json`		Als JSON ausgeben

Models

Verfügbare Modelle mit optionaler Suche und Begrenzung auflisten.

# List all models
cometapi models

# Search by keyword
cometapi models --search gemini

# Limit results and output as JSON
cometapi models --search gpt --limit 10 --json

Option	Short	Description
`--search`	`-s`	Modelle nach Schlüsselwort filtern
`--limit`	`-l`	Maximale Anzahl an Ergebnissen
`--format`	`-f`	Ausgabeformat
`--json`		Als JSON ausgeben

Balance

Ihren CometAPI-Kontostand anzeigen.

# Default: account-level balance (falls back to per-key billing)
cometapi balance

# Force account-level view
cometapi balance --source account

# Force API key billing view
cometapi balance --source key

# JSON output
cometapi balance --json

Option	Short	Description
`--source`	`-s`	Datenquelle: `account` (gesamtes Konto) oder `key` (aktueller API-Schlüssel).
`--format`	`-f`	Ausgabeformat
`--json`		Als JSON ausgeben

Account

Ihr Kontoprofil anzeigen. Erfordert ein access token.

cometapi account
cometapi account --json

Option	Short	Description
`--format`	`-f`	Ausgabeformat
`--json`		Als JSON ausgeben

Stats

Nutzungsstatistiken für den aktuellen Monat anzeigen. Erfordert ein access token.

cometapi stats
cometapi stats --json

Die Ausgabe enthält: Anzahl der Anfragen, Nutzungsbetrag, Erfolgsquote und prognostizierte verbleibende Tage bis zur Ausschöpfung des Guthabens.

Option	Short	Description
`--format`	`-f`	Ausgabeformat
`--json`		Als JSON ausgeben

Tokens

Liste deine API-Schlüssel auf und durchsuche sie. Erfordert ein access token.

# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json

Option	Short	Beschreibung
`--search`	`-s`	Suchbegriff
`--page`	`-p`	Seitennummer
`--page-size`		Ergebnisse pro Seite
`--format`	`-f`	Ausgabeformat
`--json`		Als JSON ausgeben

Logs

Durchsuche Nutzungsprotokolle mit Filtern. Erfordert ein access token.

# Recent logs
cometapi logs

# Filter by model
cometapi logs --model gpt-5.4

# Filter by date range
cometapi logs --start 2026-04-01 --end 2026-04-14

# Filter by log type
cometapi logs --type consume

# Export as CSV
cometapi logs --export > usage.csv

# JSON output with limit
cometapi logs --limit 50 --json

Option	Short	Beschreibung
`--model`	`-m`	Nach model ID filtern
`--token-name`		Nach API-Schlüsselnamen filtern
`--type`	`-t`	Protokolltyp: `consume`, `topup`, `error`, `refund`, `system`, `manage`
`--start`		Startdatum (YYYY-MM-DD)
`--end`		Enddatum (YYYY-MM-DD)
`--group`	`-g`	Nach Gruppe filtern
`--limit`	`-l`	Maximale Anzahl an Einträgen
`--page`	`-p`	Seitennummer
`--page-size`		Ergebnisse pro Seite
`--export`		Als CSV an stdout ausgeben
`--format`	`-f`	Ausgabeformat
`--json`		Als JSON ausgeben

Tasks

Zeige asynchrone Task-Protokolle für Plattformen wie Suno, Midjourney, Luma und Kling an. Erfordert ein access token.

# Recent tasks
cometapi tasks

# Filter by platform
cometapi tasks --platform suno

# Filter by status
cometapi tasks --status SUCCESS

# JSON output
cometapi tasks --json

Option	Short	Beschreibung
`--platform`		Nach Plattformnamen filtern
`--status`		Nach Status filtern
`--limit`	`-l`	Maximale Anzahl an Einträgen
`--format`	`-f`	Ausgabeformat
`--json`		Als JSON ausgeben

Doctor

Führe Diagnosen aus, um die CLI-Konfiguration und API-Konnektivität zu überprüfen.

cometapi doctor
cometapi doctor --json

Der Doctor prüft:

Vorhandensein und Lesbarkeit der Konfigurationsdatei
Verfügbarkeit und Quelle des API-Schlüssels (config, env oder fehlend)
Verfügbarkeit des access token
Netzwerkverbindung zum CometAPI-Endpunkt
Gültigkeit der API-Authentifizierung

Option	Short	Beschreibung
`--format`	`-f`	Ausgabeformat
`--json`		Als JSON ausgeben

Config

Verwalte die CLI-Konfiguration, die in ~/.config/cometapi/config.toml gespeichert ist.

# Show current config
cometapi config show

# Set a value
cometapi config set api_key sk-...
cometapi config set default_model claude-sonnet-4-6
cometapi config set output_format json

# Remove a value
cometapi config unset api_key

# Show config file path
cometapi config path

Siehe den Konfigurationsleitfaden für alle verfügbaren Schlüssel.

Init

Führe den interaktiven Einrichtungsassistenten aus, um deinen API-Schlüssel und access token zu konfigurieren.

cometapi init

Der Assistent schreibt die Einstellungen in ~/.config/cometapi/config.toml.

Repl

Starte eine vollständige interaktive Kommando-Shell, in der du jeden CLI-Befehl ohne das Präfix cometapi ausführen kannst.

cometapi repl

Output formats

Alle Datenbefehle unterstützen --json oder --format:

cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown

Format	Beschreibung
`table`	Erweiterte Tabelle im Terminal (Standard)
`json`	JSON-Ausgabe
`yaml`	YAML-Ausgabe
`csv`	Kommagetrennte Werte
`markdown`	Markdown-Tabelle

Lege über config ein Standardformat für alle Befehle fest:

cometapi config set output_format json

Shell completion

Installiere Shell-Completion für Unterstützung bei der Tab-Vervollständigung:

cometapi --install-completion

Unterstützte Shells: Bash, Zsh, Fish.

Exit-Codes

Code	Bedeutung
`0`	Erfolg
`1`	Allgemeiner Fehler
`2`	Ungültige Argumente
`64`	Konfiguration fehlt
`69`	Dienst nicht verfügbar
`77`	Authentifizierungsfehler

Übersicht

API-Referenz

Integrationsleitfäden

Entwicklertools

Fehler

Preise & Abrechnung

Support

Befehlsübersicht

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

Shell completion

Exit-Codes

Übersicht

API-Referenz

Integrationsleitfäden

Entwicklertools

Fehler

Preise & Abrechnung

Support

​Befehlsübersicht

​Chat

​Models

​Balance

​Account

​Stats

​Tokens

​Logs

​Tasks

​Doctor

​Config

​Init

​Repl

​Output formats

​Shell completion

​Exit-Codes

Befehlsübersicht

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

Shell completion

Exit-Codes