Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Die CometAPI CLI liest Einstellungen aus einer TOML-Konfigurationsdatei, Umgebungsvariablen und Kommandozeilen-Flags. Wenn dieselbe Einstellung aus mehreren Quellen verfügbar ist, gilt folgende Prioritätsreihenfolge: CLI-Flags > Konfigurationsdatei > Umgebungsvariablen > Standardwerte

Konfigurationsdatei

Speicherort: ~/.config/cometapi/config.toml Führen Sie den Einrichtungsassistenten aus, um die Konfigurationsdatei interaktiv zu erstellen:
cometapi init
Oder verwalten Sie einzelne Einstellungen mit dem Unterbefehl config:
# View current configuration
cometapi config show

# Set a value
cometapi config set api_key sk-...

# Remove a value
cometapi config unset api_key

# Show the config file path
cometapi config path

Verfügbare Einstellungen

Config keyEnvironment variableDescription
api_keyCOMETAPI_KEYAPI key (für alle Befehle erforderlich)
access_tokenCOMETAPI_ACCESS_TOKENAccess token für Befehle auf Kontoebene
base_urlCOMETAPI_BASE_URLAPI-Basis-URL (Standard: https://api.cometapi.com/v1)
default_modelCOMETAPI_DEFAULT_MODELStandardmodell für chat (Fallback: gpt-5.4)
output_formatStandard-Ausgabeformat: table, json, yaml, csv oder markdown

Anmeldedaten

Die CLI verwendet zwei Arten von Anmeldedaten:

API key

Für alle Befehle erforderlich. Der API key authentifiziert Anfragen an die CometAPI-Modellendpunkte. Erstellen Sie einen API key unter CometAPI Console → API Keys. Legen Sie ihn auf eine der folgenden Arten fest:
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY

Access token

Optional. Der Access token ist für Befehle auf Kontoebene erforderlich: account, stats, tokens, logs und tasks. Generieren Sie einen Access token unter CometAPI Console → Personal Settings. Legen Sie ihn auf eine der folgenden Arten fest:
export COMETAPI_ACCESS_TOKEN="your-access-token"

Sicherheit

Die CLI wendet folgende Sicherheitspraktiken an:
  • API keys und Access tokens werden niemals protokolliert oder vollständig angezeigt. In der Diagnoseausgabe werden nur die letzten 4 Zeichen angezeigt.
  • Die Konfigurationsdatei wird mit restriktiven Berechtigungen (0600) erstellt — nur für den Dateieigentümer lesbar.
  • Anmeldedaten sollten niemals in die Versionskontrolle eingecheckt werden. Fügen Sie den Pfad der Konfigurationsdatei zu Ihrer .gitignore hinzu, falls zutreffend.
Sie sind für sämtliche Nutzung und Gebühren verantwortlich, die mit Ihren API keys anfallen. Bewahren Sie Ihre Schlüssel sicher auf und rotieren Sie sie, wenn Sie unbefugten Zugriff vermuten.

Fehlerbehebung

ErrorSolution
API key not configuredFühren Sie cometapi init aus oder setzen Sie die Umgebungsvariable COMETAPI_KEY
Connection failedFühren Sie cometapi doctor aus, um die Konnektivität zu diagnostizieren
Access token not configuredNur erforderlich für account/stats/tokens/logs/tasks. Führen Sie cometapi init aus, um einen hinzuzufügen