Referencja poleceń

Użyj cometapi -h lub cometapi <command> -h, aby sprawdzić dokładne argumenty i opcje dla zainstalowanej wersji.

Przegląd poleceń

Command	Description	Auth
`chat [MESSAGE]`	Wyślij wiadomość chat lub uruchom chat REPL	Klucz API
`models`	Wyświetl i filtruj metadane katalogu modeli	Klucz API
`model info <id>`	Sprawdź publiczne metadane pojedynczego modelu	Klucz API
`run [MODEL]`	Wyślij jedno żądanie w formacie chat, responses, anthropic lub gemini	Klucz API
`balance`	Pokaż saldo konta lub bieżącego klucza API	Klucz API lub access token
`account`	Pokaż profil konta	Access token
`stats`	Pokaż statystyki użycia	Access token
`tokens`	Wyświetl i wyszukuj klucze API	Access token
`logs`	Przeglądaj logi użycia z filtrami	Access token
`tasks`	Pokaż logi zadań asynchronicznych	Access token
`init`	Uruchom kreator konfiguracji	Brak
`doctor`	Uruchom diagnostykę	Klucz API
`config`	Zarządzaj lokalną konfiguracją	Brak
`repl`	Uruchom interaktywną powłokę poleceń	Zależy od użytego polecenia

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 chat REPL.

cometapi chat "Explain CometAPI in one sentence."
cometapi chat "Summarize this" --model your-model-id --system "Be concise."
cometapi chat "Hello" --no-stream
cometapi chat "Hello" --json
cometapi chat

Option	Short	Description
`--model`	`-m`	Model do użycia
`--system`	`-s`	System prompt
`--temperature`	`-t`	Temperatura próbkowania
`--max-tokens`		Maksymalna liczba tokenów odpowiedzi
`--stream/--no-stream`		Włącz lub wyłącz Streaming
`--format`	`-f`	Format wyjścia
`--json`		Wyjście jako JSON

Models

Domyślnie wyświetla modele z publicznego katalogu. Wynik katalogu zawiera model ID, dostawcę, typ modelu, funkcje, endpointy, ceny, długość kontekstu oraz maksymalną liczbę tokenów completion.

cometapi models
cometapi models --search gpt --limit 10
cometapi models --provider openai --type chat --limit 10
cometapi models --feature image --endpoint responses --json
cometapi models --refresh
cometapi models --source openai --search gpt

Option	Short	Description
`--search`	`-s`	Filtruj według ID, kodu, nazwy, opisu lub dostawcy
`--provider`		Filtruj według nazwy lub kodu dostawcy
`--type`, `--modality`		Filtruj według typu modelu lub modality
`--feature`, `--capability`		Filtruj według funkcji lub capability
`--endpoint`		Filtruj według nazwy endpointu, metody lub ścieżki
`--limit`	`-l`	Maksymalna liczba wyników
`--source`		Użyj metadanych `catalog` lub listy `openai` zgodnej z OpenAI
`--refresh`		Odśwież jednogodzinny cache katalogu
`--no-cache`		Pomiń cache katalogu dla tego polecenia
`--format`	`-f`	Format wyjścia
`--json`		Wyjście jako JSON

Cache katalogu jest przechowywany w ~/.cache/cometapi/models.json.

Informacje o modelu

Sprawdź publiczne metadane pojedynczego modelu. Polecenie rozpoznaje model za pomocą publicznego katalogu, a następnie wczytuje szczegółowe metadane dla kodu katalogowego.

cometapi model info your-model-id
cometapi model info your-model-id --json
cometapi model info your-model-id --refresh

Option	Short	Description
`--refresh`		Odśwież pamięć podręczną katalogu przed wyszukaniem
`--no-cache`		Pomiń pamięć podręczną katalogu dla tego polecenia
`--format`	`-f`	Format wyjścia
`--json`		Wyświetl surowy JSON szczegółów modelu

Dane wyjściowe tabeli obejmują dostawcę, typ modelu, funkcje, endpointy, ceny, długość kontekstu, maksymalną liczbę tokenów completion, URL dokumentacji oraz przegląd.

Uruchom

Wyślij jedno żądanie przez wybrany format endpointu. Użyj --input-file dla ciała JSON, powtarzanych wartości -i key=value dla nadpisań oraz -p/--prompt jako skrótu dla promptu.

cometapi run your-model-id -p "Write one sentence about CometAPI."
cometapi run your-model-id --endpoint responses -p "Reply with OK only." -i max_output_tokens=32 --json
cometapi run your-model-id --endpoint anthropic -p "Reply with OK only." -i max_tokens=32
cometapi run your-model-id --endpoint gemini -p "Reply with OK only." -i generationConfig.maxOutputTokens=32
cometapi run your-model-id --endpoint responses --input-file body.json -i temperature=0.2 --json

Option	Short	Description
`--endpoint`	`-e`	Format endpointu: `chat`, `responses`, `anthropic` lub `gemini`
`--input-file`		Ciało żądania jako obiekt JSON
`--input`	`-i`	Dane wejściowe żądania jako `key=value`; powtórz dla wielu wartości
`--prompt`	`-p`	Skrót dla promptu
`--json`		Wyświetl surową odpowiedź JSON

Mapowanie endpointów:

Endpoint	Request path	Auth
`chat`	`POST /v1/chat/completions`	Klucz API Bearer
`responses`	`POST /v1/responses`	Klucz API Bearer
`anthropic`	`POST /v1/messages`	Klucz API `x-api-key` i nagłówek wersji Anthropic
`gemini`	Ścieżka modelu Gemini Generate Content	Klucz API `x-goog-api-key`

Kolejność scalania ciała to --input-file, powtarzane -i key=value, skrót promptu, a następnie pozycyjny MODEL. Wartości inline są parsowane jako JSON, gdy to możliwe. Klucze rozdzielone kropkami tworzą obiekty zagnieżdżone.

Saldo

Pokaż saldo swojego konta CometAPI lub bieżący widok rozliczeń dla klucza API.

cometapi balance
cometapi balance --source account
cometapi balance --source key
cometapi balance --json

Option	Short	Description
`--source`	`-s`	Źródło danych: `account` lub `key`
`--format`	`-f`	Format wyjścia
`--json`		Wyjście jako JSON

Konto

Pokaż profil swojego konta. Wymaga tokenu dostępu.

cometapi account
cometapi account --json

Statystyki

Pokaż statystyki użycia. Wymaga tokenu dostępu.

cometapi stats
cometapi stats --json

Tokeny

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

cometapi tokens
cometapi tokens --search project
cometapi tokens --json

Option	Short	Description
`--search`	`-s`	Słowo kluczowe wyszukiwania
`--page`	`-p`	Numer strony
`--limit`	`-l`	Liczba wyników na stronę
`--format`	`-f`	Format wyjścia
`--json`		Wyjście jako JSON

Logi

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

cometapi logs
cometapi logs --model your-model-id
cometapi logs --start 2026-04-01 --end 2026-04-14
cometapi logs --type consume
cometapi logs --export > usage.csv
cometapi logs --limit 50 --json
cometapi logs --request-id 20260617165550885561292gJBlzjtp

Option	Short	Description
`--model`	`-m`	Filtruj według model ID
`--token-name`	`-t`	Filtruj według nazwy klucza API
`--type`		Typ logu
`--search`	`-s`	Słowo kluczowe wyszukiwania
`--start`		Data początkowa
`--end`		Data końcowa
`--group`	`-g`	Filtruj według grupy klucza API
`--request-id`		Wyszukaj pojedyncze żądanie według `X-Cometapi-Request-Id`
`--page`	`-p`	Numer strony
`--limit`	`-l`	Wyniki na stronę
`--export`		Wyślij po stronie serwera CSV na stdout
`--format`	`-f`	Format wyjściowy
`--json`		Wyjście jako JSON

logs --request-id wykonuje jedno indeksowane wyszukiwanie względem endpointu logów operatora i akceptuje wyłącznie dokładne dopasowanie request_id. CLI nie skanuje zapasowych stron logów, ponieważ endpoint self-log nie stosuje filtrowania request_id.

Zadania

Pokaż logi zadań asynchronicznych. Wymaga tokenu dostępu.

cometapi tasks
cometapi tasks --platform kling
cometapi tasks --status SUCCESS
cometapi tasks --json

Option	Short	Description
`--platform`	`-p`	Filtruj według platformy
`--task-id`		Filtruj według ID zadania
`--status`	`-s`	Filtruj według statusu
`--action`	`-a`	Filtruj według typu akcji
`--start`		Data początkowa
`--end`		Data końcowa
`--page`		Numer strony
`--limit`	`-l`	Wyniki na stronę
`--format`	`-f`	Format wyjściowy
`--json`		Wyjście jako JSON

Doctor

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

cometapi doctor
cometapi doctor --json

Config

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

cometapi config show
cometapi config set api_key "$COMETAPI_KEY"
cometapi config set default_model your-model-id
cometapi config unset api_key
cometapi config path

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

Init

Uruchom interaktywny kreator konfiguracji:

cometapi init

Repl

Uruchom w pełni interaktywną powłokę poleceń:

cometapi repl

Formaty wyjściowe

Większość poleceń danych obsługuje --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
`json`	Wyjście JSON
`yaml`	Wyjście YAML
`csv`	Wartości rozdzielone przecinkami
`markdown`	Tabela Markdown

Zacznij tutaj

Szybki start z API modeli

Podstawowe przewodniki po API

Biblioteki

Błędy

Ceny i rozliczenia

Wsparcie

Przegląd poleceń

Chat

Models

Informacje o modelu

Uruchom

Saldo

Konto

Statystyki

Tokeny

Logi

Zadania

Doctor

Config

Init

Repl

Formaty wyjściowe

​Przegląd poleceń

​Chat

​Models

​Informacje o modelu

​Uruchom

​Saldo

​Konto

​Statystyki

​Tokeny

​Logi

​Zadania

​Doctor

​Config

​Init

​Repl

​Formaty wyjściowe

Przegląd poleceń

Chat

Models

Informacje o modelu

Uruchom

Saldo

Konto

Statystyki

Tokeny

Logi

Zadania

Doctor

Config

Init

Repl

Formaty wyjściowe