Dokumentacja poleceń

Przegląd poleceń

Command	Description	Auth
`chat [MESSAGE]`	Wyślij wiadomość lub uruchom interaktywny REPL	Klucz API
`models`	Wyświetl i wyszukuj dostępne modele	Klucz API
`balance`	Pokaż saldo konta	Klucz API (lub access token)
`account`	Pokaż profil konta	Access token
`stats`	Pokaż statystyki użycia	Access token
`tokens`	Wyświetl i wyszukuj swoje klucze API	Access token
`logs`	Przeglądaj logi użycia z filtrami	Access token
`tasks`	Pokaż logi zadań asynchronicznych	Access token
`init`	Interaktywny kreator konfiguracji	—
`doctor`	Uruchom diagnostykę i kontrole stanu	Klucz API
`config`	Zarządzaj konfiguracją CLI	—
`repl`	Uruchom interaktywną powłokę poleceń	Klucz API

Polecenia oznaczone jako Access token wymagają zmiennej środowiskowej COMETAPI_ACCESS_TOKEN lub klucza konfiguracyjnego access_token. Szczegóły znajdziesz w przewodniku po konfiguracji.

Chat

Wyślij pojedynczą wiadomość lub uruchom wieloturowy interaktywny REPL.

# 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`	Model do użycia (domyślnie: z konfiguracji)
`--system`	`-s`	Prompt systemowy
`--temperature`	`-t`	Temperatura próbkowania (0.0–2.0)
`--max-tokens`		Maksymalna liczba tokens w odpowiedzi
`--stream/--no-stream`		Włącz lub wyłącz Streaming (domyślnie: stream)
`--format`	`-f`	Format wyjściowy
`--json`		Dane wyjściowe jako JSON

Models

Wyświetl dostępne modele z opcjonalnym wyszukiwaniem i limitem.

# 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`	Filtruj modele według słowa kluczowego
`--limit`	`-l`	Maksymalna liczba wyników
`--format`	`-f`	Format wyjściowy
`--json`		Dane wyjściowe jako JSON

Balance

Pokaż saldo swojego konta CometAPI.

# 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`	Źródło danych: `account` (całe konto) lub `key` (bieżący klucz API).
`--format`	`-f`	Format wyjściowy
`--json`		Dane wyjściowe jako JSON

Account

Pokaż profil swojego konta. Wymaga access token.

cometapi account
cometapi account --json

Option	Short	Description
`--format`	`-f`	Format wyjściowy
`--json`		Dane wyjściowe jako JSON

Stats

Pokaż statystyki użycia dla bieżącego miesiąca. Wymaga access token.

cometapi stats
cometapi stats --json

Dane wyjściowe obejmują: liczbę żądań, wielkość użycia, wskaźnik powodzenia oraz przewidywaną liczbę dni pozostałych do wyczerpania salda.

Option	Short	Description
`--format`	`-f`	Format wyjściowy
`--json`		Dane wyjściowe jako JSON

Tokens

Wyświetl i wyszukuj swoje klucze API. Wymaga tokenu dostępu.

# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json

Option	Short	Description
`--search`	`-s`	Słowo kluczowe wyszukiwania
`--page`	`-p`	Numer strony
`--page-size`		Wyniki na stronę
`--format`	`-f`	Format wyjścia
`--json`		Wyjście jako JSON

Logs

Przeglądaj logi użycia z filtrami. Wymaga tokenu dostępu.

# 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	Description
`--model`	`-m`	Filtruj według model ID
`--token-name`		Filtruj według nazwy klucza API
`--type`	`-t`	Typ logu: `consume`, `topup`, `error`, `refund`, `system`, `manage`
`--start`		Data początkowa (YYYY-MM-DD)
`--end`		Data końcowa (YYYY-MM-DD)
`--group`	`-g`	Filtruj według grupy
`--limit`	`-l`	Maksymalna liczba wpisów
`--page`	`-p`	Numer strony
`--page-size`		Wyniki na stronę
`--export`		Wyjście jako CSV do stdout
`--format`	`-f`	Format wyjścia
`--json`		Wyjście jako JSON

Tasks

Pokaż logi zadań asynchronicznych dla platform takich jak Suno, Midjourney, Luma i Kling. Wymaga tokenu dostępu.

# 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	Description
`--platform`		Filtruj według nazwy platformy
`--status`		Filtruj według statusu
`--limit`	`-l`	Maksymalna liczba wpisów
`--format`	`-f`	Format wyjścia
`--json`		Wyjście jako JSON

Doctor

Uruchom diagnostykę, aby zweryfikować konfigurację CLI i łączność z API.

cometapi doctor
cometapi doctor --json

Doctor sprawdza:

Istnienie pliku konfiguracyjnego i możliwość jego odczytu
Dostępność klucza API i jego źródło (config, env lub brak)
Dostępność tokenu dostępu
Łączność sieciową z endpointem CometAPI
Poprawność uwierzytelniania API

Option	Short	Description
`--format`	`-f`	Format wyjścia
`--json`		Wyjście jako JSON

Config

Zarządzaj konfiguracją CLI przechowywaną w ~/.config/cometapi/config.toml.

# 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

Zobacz przewodnik po konfiguracji, aby poznać wszystkie dostępne klucze.

Init

Uruchom interaktywny kreator konfiguracji, aby skonfigurować klucz API i token dostępu.

cometapi init

Kreator zapisuje ustawienia w ~/.config/cometapi/config.toml.

Repl

Uruchom w pełni interaktywną powłokę poleceń, w której możesz wykonywać dowolne polecenie CLI bez prefiksu cometapi.

cometapi repl

Output formats

Wszystkie polecenia danych obsługują --json lub --format:

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

Format	Description
`table`	Rozbudowana tabela w terminalu (domyślnie)
`json`	Wyjście JSON
`yaml`	Wyjście YAML
`csv`	Wartości rozdzielane przecinkami
`markdown`	Tabela Markdown

Ustaw domyślny format dla wszystkich poleceń przez config:

cometapi config set output_format json

Shell completion

Zainstaluj uzupełnianie powłoki, aby włączyć obsługę autouzupełniania klawiszem Tab:

cometapi --install-completion

Obsługiwane powłoki: Bash, Zsh, Fish.

Kody wyjścia

Code	Znaczenie
`0`	Sukces
`1`	Błąd ogólny
`2`	Nieprawidłowe argumenty
`64`	Brak konfiguracji
`69`	Usługa niedostępna
`77`	Błąd uwierzytelniania

Przegląd

Dokumentacja referencyjna API

Przewodniki integracji

Narzędzia deweloperskie

Błędy

Cennik i rozliczenia

Wsparcie

Przegląd poleceń

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

Shell completion

Kody wyjścia

Przegląd

Dokumentacja referencyjna API

Przewodniki integracji

Narzędzia deweloperskie

Błędy

Cennik i rozliczenia

Wsparcie

​Przegląd poleceń

​Chat

​Models

​Balance

​Account

​Stats

​Tokens

​Logs

​Tasks

​Doctor

​Config

​Init

​Repl

​Output formats

​Shell completion

​Kody wyjścia

Przegląd poleceń

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

Shell completion

Kody wyjścia