> ## 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.

# Referencja poleceń

> Referencja poleceń CometAPI CLI, w tym chat, models, model info, run, balance, account, stats, tokens, logs, tasks, doctor, config i repl.

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](/pl/libraries/cli/configuration).

## Chat

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

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
cometapi account
cometapi account --json
```

## Statystyki

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

```bash theme={null}
cometapi stats
cometapi stats --json
```

## Tokeny

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

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
cometapi doctor
cometapi doctor --json
```

## Config

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

```bash theme={null}
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](/pl/libraries/cli/configuration), aby poznać wszystkie dostępne klucze.

## Init

Uruchom interaktywny kreator konfiguracji:

```bash theme={null}
cometapi init
```

## Repl

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

```bash theme={null}
cometapi repl
```

## Formaty wyjściowe

Większość poleceń danych obsługuje `--json` lub `--format`:

```bash theme={null}
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                  |
