Przejdź do głównej treści
CometAPI CLI odczytuje ustawienia z pliku konfiguracyjnego TOML, zmiennych środowiskowych i flag wiersza poleceń. Gdy to samo ustawienie jest dostępne z wielu źródeł, kolejność priorytetu jest następująca: Flagi CLI > plik konfiguracyjny > zmienne środowiskowe > wartości domyślne

Plik konfiguracyjny

Lokalizacja: ~/.config/cometapi/config.toml Uruchom kreatora konfiguracji, aby interaktywnie utworzyć plik konfiguracyjny:
cometapi init
Lub zarządzaj poszczególnymi ustawieniami za pomocą podkomendy 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

Dostępne ustawienia

Klucz konfiguracjiZmienna środowiskowaOpis
api_keyCOMETAPI_KEYAPI key (wymagany dla wszystkich poleceń)
access_tokenCOMETAPI_ACCESS_TOKENAccess token dla poleceń na poziomie konta
base_urlCOMETAPI_BASE_URLBazowy URL API (domyślnie: https://api.cometapi.com/v1)
default_modelCOMETAPI_DEFAULT_MODELDomyślny model dla chat (fallback: gpt-5.4)
output_formatDomyślny format wyjścia: table, json, yaml, csv lub markdown

Poświadczenia

CLI używa dwóch typów poświadczeń:

API key

Wymagany dla wszystkich poleceń. API key uwierzytelnia żądania do endpointów modeli CometAPI. Utwórz API key w CometAPI Console → API Keys. Ustaw go na jeden z tych sposobów:
export COMETAPI_KEY="<COMETAPI_KEY>"

Access token

Opcjonalny. Access token jest wymagany dla poleceń na poziomie konta: account, stats, tokens, logs i tasks. Wygeneruj access token w CometAPI Console → Personal Settings. Ustaw go na jeden z tych sposobów:
export COMETAPI_ACCESS_TOKEN="your-access-token"

Bezpieczeństwo

CLI stosuje następujące praktyki bezpieczeństwa:
  • API keys i access tokens nigdy nie są logowane ani wyświetlane w całości. W danych diagnostycznych pokazywane są tylko ostatnie 4 znaki.
  • Plik konfiguracyjny jest tworzony z restrykcyjnymi uprawnieniami (0600) — do odczytu wyłącznie przez właściciela pliku.
  • Poświadczenia nigdy nie powinny być commitowane do systemu kontroli wersji. W razie potrzeby dodaj ścieżkę pliku konfiguracyjnego do swojego .gitignore.
Ponosisz odpowiedzialność za całe użycie i opłaty naliczone z użyciem Twoich API keys. Przechowuj swoje klucze bezpiecznie i rotuj je, jeśli podejrzewasz nieautoryzowany dostęp.

Rozwiązywanie problemów

BłądRozwiązanie
API key not configuredUruchom cometapi init lub ustaw zmienną środowiskową COMETAPI_KEY
Connection failedUruchom cometapi doctor, aby zdiagnozować łączność
Access token not configuredWymagany tylko dla account/stats/tokens/logs/tasks. Uruchom cometapi init, aby go dodać