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.
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 | System prompt |
--temperature | -t | Temperatura próbkowania (0.0–2.0) |
--max-tokens | | Maksymalna liczba tokenów w odpowiedzi |
--stream/--no-stream | | Włącz lub wyłącz Streaming (domyślnie: stream) |
--format | -f | Format wyjściowy |
--json | | Wyjście 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 | | Wyjście 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 | | Wyjście jako JSON |
Account
Pokaż profil swojego konta. Wymaga access tokena.
cometapi account
cometapi account --json
| Option | Short | Description |
|---|
--format | -f | Format wyjściowy |
--json | | Wyjście jako JSON |
Stats
Pokaż statystyki użycia dla bieżącego miesiąca. Wymaga access tokena.
cometapi stats
cometapi stats --json
Dane wyjściowe obejmują: liczbę żądań, wielkość użycia, współczynnik powodzenia oraz przewidywaną liczbę dni pozostałych do wyczerpania salda.
| Option | Short | Description |
|---|
--format | -f | Format wyjściowy |
--json | | Wyjście jako JSON |
Tokens
Wyświetl i wyszukuj swoje klucze API. Wymaga access tokena.
# List API keys (paginated)
cometapi tokens
# Search by keyword
cometapi tokens --search raycast
# JSON output
cometapi tokens --json
| Option | Short | Description |
|---|
--search | -s | Szukane słowo kluczowe |
--page | -p | Numer strony |
--page-size | | Wyniki na stronę |
--format | -f | Format wyjściowy |
--json | | Wyjście jako JSON |
Logs
Przeglądaj logi użycia z filtrami. Wymaga access tokena.
# 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ściowy |
--json | | Wyjście jako JSON |
Tasks
Pokaż logi zadań asynchronicznych dla platform takich jak Midjourney, Luma i Kling. Wymaga access tokena.
# Recent tasks
cometapi tasks
# Filter by platform
cometapi tasks --platform kling
# 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ściowy |
--json | | Wyjście jako JSON |
Doctor
Uruchom diagnostykę, aby zweryfikować konfigurację CLI i łączność z API.
cometapi doctor
cometapi doctor --json
Diagnostyka sprawdza:
- Istnienie pliku konfiguracyjnego i możliwość jego odczytu
- Dostępność klucza API i jego źródło (config, env lub brak)
- Dostępność access tokena
- Łączność sieciową z endpointem CometAPI
- Poprawność uwierzytelniania API
| Option | Short | Description |
|---|
--format | -f | Format wyjściowy |
--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
W przewodniku po konfiguracji znajdziesz wszystkie dostępne klucze.
Init
Uruchom interaktywny kreator konfiguracji, aby skonfigurować klucz API i access token.
Kreator zapisuje ustawienia do ~/.config/cometapi/config.toml.
Repl
Uruchom pełną interaktywną powłokę poleceń, w której możesz wykonywać dowolne polecenia CLI bez prefiksu cometapi.
Wszystkie polecenia dotyczące 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ń za pomocą konfiguracji:
cometapi config set output_format json
Uzupełnianie poleceń w powłoce
Zainstaluj uzupełnianie poleceń w powłoce, aby włączyć podpowiedzi po naciśnięciu Tab:
cometapi --install-completion
Obsługiwane powłoki: Bash, Zsh, Fish.
Kody wyjścia
| Code | Meaning |
|---|
0 | Sukces |
1 | Błąd ogólny |
2 | Nieprawidłowe argumenty |
64 | Brak konfiguracji |
69 | Usługa niedostępna |
77 | Błąd uwierzytelniania |