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

# Довідник команд

> Довідник команд CometAPI CLI, включно з chat, models, model info, run, balance, account, stats, tokens, logs, tasks, doctor, config і repl.

Використовуйте `cometapi -h` або `cometapi <command> -h`, щоб переглянути точні аргументи й опції для встановленої версії.

## Огляд команд

| Command           | Description                                                           | Auth                    |
| ----------------- | --------------------------------------------------------------------- | ----------------------- |
| `chat [MESSAGE]`  | Надіслати повідомлення в чат або запустити chat REPL                  | API key                 |
| `models`          | Переглянути та відфільтрувати метадані каталогу моделей               | API key                 |
| `model info <id>` | Переглянути публічні метадані однієї моделі                           | API key                 |
| `run [MODEL]`     | Надіслати один запит у форматах chat, responses, anthropic або gemini | API key                 |
| `balance`         | Показати баланс акаунта або поточного API key                         | API key or access token |
| `account`         | Показати профіль акаунта                                              | Access token            |
| `stats`           | Показати статистику використання                                      | Access token            |
| `tokens`          | Переглянути та знайти API key                                         | Access token            |
| `logs`            | Переглядати журнали використання з фільтрами                          | Access token            |
| `tasks`           | Показати журнали асинхронних завдань                                  | Access token            |
| `init`            | Запустити майстер налаштування                                        | None                    |
| `doctor`          | Запустити діагностику                                                 | API key                 |
| `config`          | Керувати локальною конфігурацією                                      | None                    |
| `repl`            | Запустити інтерактивну командну оболонку                              | Depends on command used |

Для команд, позначених **Access token**, потрібна змінна середовища `COMETAPI_ACCESS_TOKEN` або ключ конфігурації `access_token`. Докладніше дивіться в [посібнику з конфігурації](/uk/libraries/cli/configuration).

## Chat

Надішліть одне повідомлення або запустіть багатоходовий 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`  | Модель для використання               |
| `--system`             | `-s`  | Системний Prompt                      |
| `--temperature`        | `-t`  | Температура семплювання               |
| `--max-tokens`         |       | Максимальна кількість response Tokens |
| `--stream/--no-stream` |       | Увімкнути або вимкнути Streaming      |
| `--format`             | `-f`  | Формат виводу                         |
| `--json`               |       | Вивести як JSON                       |

## Models

За замовчуванням показує моделі з публічного каталогу. Вивід каталогу містить model ID, provider, model type, features, endpoints, pricing, context length і maximum completion tokens.

```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`  | Фільтрувати за ID, кодом, назвою, описом або provider                  |
| `--provider`                |       | Фільтрувати за назвою або кодом provider                               |
| `--type`, `--modality`      |       | Фільтрувати за типом моделі або modality                               |
| `--feature`, `--capability` |       | Фільтрувати за feature або capability                                  |
| `--endpoint`                |       | Фільтрувати за назвою endpoint, методом або шляхом                     |
| `--limit`                   | `-l`  | Максимальна кількість результатів                                      |
| `--source`                  |       | Використовувати метадані `catalog` або OpenAI-сумісний список `openai` |
| `--refresh`                 |       | Оновити одногодинний кеш каталогу                                      |
| `--no-cache`                |       | Обійти кеш каталогу для цієї команди                                   |
| `--format`                  | `-f`  | Формат виводу                                                          |
| `--json`                    |       | Вивести як JSON                                                        |

Кеш каталогу зберігається в `~/.cache/cometapi/models.json`.

## Інформація про модель

Перегляньте публічні метадані для однієї моделі. Команда визначає модель через публічний каталог, а потім завантажує детальні метадані для коду каталогу.

```bash theme={null}
cometapi model info your-model-id
cometapi model info your-model-id --json
cometapi model info your-model-id --refresh
```

| Параметр     | Коротко | Опис                                         |
| ------------ | ------- | -------------------------------------------- |
| `--refresh`  |         | Оновити кеш каталогу перед пошуком           |
| `--no-cache` |         | Обійти кеш каталогу для цієї команди         |
| `--format`   | `-f`    | Формат виводу                                |
| `--json`     |         | Вивести необроблений JSON із деталями моделі |

Табличний вивід містить provider, тип моделі, features, endpoints, pricing, довжину контексту, максимальну кількість completion tokens, URL документації та огляд.

## Виконання

Надішліть один запит через вибраний формат endpoint. Використовуйте `--input-file` для JSON body, повторювані значення `-i key=value` для перевизначень і `-p/--prompt` як скорочення для prompt.

```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
```

| Параметр       | Коротко | Опис                                                                    |
| -------------- | ------- | ----------------------------------------------------------------------- |
| `--endpoint`   | `-e`    | Формат endpoint: `chat`, `responses`, `anthropic` або `gemini`          |
| `--input-file` |         | JSON object request body                                                |
| `--input`      | `-i`    | Вхідні дані запиту у форматі `key=value`; повторіть для кількох значень |
| `--prompt`     | `-p`    | Скорочення для prompt                                                   |
| `--json`       |         | Вивести необроблену JSON-відповідь                                      |

Відображення endpoint:

| Endpoint    | Шлях запиту                         | Auth                                             |
| ----------- | ----------------------------------- | ------------------------------------------------ |
| `chat`      | `POST /v1/chat/completions`         | Bearer API key                                   |
| `responses` | `POST /v1/responses`                | Bearer API key                                   |
| `anthropic` | `POST /v1/messages`                 | API key `x-api-key` і заголовок версії Anthropic |
| `gemini`    | Шлях моделі Gemini Generate Content | API key `x-goog-api-key`                         |

Порядок злиття body: `--input-file`, повторювані `-i key=value`, скорочення для prompt, потім позиційний `MODEL`. Вбудовані значення аналізуються як JSON, коли це можливо. Ключі з крапками створюють вкладені об’єкти.

## Баланс

Покажіть баланс вашого облікового запису CometAPI або поточне представлення білінгу API key.

```bash theme={null}
cometapi balance
cometapi balance --source account
cometapi balance --source key
cometapi balance --json
```

| Параметр   | Коротко | Опис                               |
| ---------- | ------- | ---------------------------------- |
| `--source` | `-s`    | Джерело даних: `account` або `key` |
| `--format` | `-f`    | Формат виводу                      |
| `--json`   |         | Вивести як JSON                    |

## Обліковий запис

Покажіть профіль вашого облікового запису. Потрібен access token.

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

## Статистика

Покажіть статистику використання. Потрібен access token.

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

## Tokens

Перелічіть і знайдіть API keys. Потрібен access token.

```bash theme={null}
cometapi tokens
cometapi tokens --search project
cometapi tokens --json
```

| Параметр   | Коротко | Опис                     |
| ---------- | ------- | ------------------------ |
| `--search` | `-s`    | Ключове слово для пошуку |
| `--page`   | `-p`    | Номер сторінки           |
| `--limit`  | `-l`    | Результатів на сторінку  |
| `--format` | `-f`    | Формат виводу            |
| `--json`   |         | Вивести як JSON          |

## Журнали

Переглядайте журнали використання з фільтрами. Потрібен access token.

```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`  | Фільтрувати за model ID                      |
| `--token-name` | `-t`  | Фільтрувати за назвою API key                |
| `--type`       |       | Тип журналу                                  |
| `--search`     | `-s`  | Ключове слово для пошуку                     |
| `--start`      |       | Дата початку                                 |
| `--end`        |       | Дата завершення                              |
| `--group`      | `-g`  | Фільтрувати за групою API key                |
| `--request-id` |       | Знайти один запит за `X-Cometapi-Request-Id` |
| `--page`       | `-p`  | Номер сторінки                               |
| `--limit`      | `-l`  | Результатів на сторінку                      |
| `--export`     |       | Вивести server-side CSV у stdout             |
| `--format`     | `-f`  | Формат виводу                                |
| `--json`       |       | Вивести як JSON                              |

`logs --request-id` виконує один індексований пошук через endpoint журналу оператора і
приймає лише точний збіг `request_id`. CLI не сканує резервні сторінки журналів,
оскільки endpoint self-log не застосовує фільтрацію за `request_id`.

## Завдання

Показати журнали асинхронних завдань. Потрібен access token.

```bash theme={null}
cometapi tasks
cometapi tasks --platform kling
cometapi tasks --status SUCCESS
cometapi tasks --json
```

| Option       | Short | Description                |
| ------------ | ----- | -------------------------- |
| `--platform` | `-p`  | Фільтрувати за платформою  |
| `--task-id`  |       | Фільтрувати за ID завдання |
| `--status`   | `-s`  | Фільтрувати за статусом    |
| `--action`   | `-a`  | Фільтрувати за типом дії   |
| `--start`    |       | Дата початку               |
| `--end`      |       | Дата завершення            |
| `--page`     |       | Номер сторінки             |
| `--limit`    | `-l`  | Результатів на сторінку    |
| `--format`   | `-f`  | Формат виводу              |
| `--json`     |       | Вивести як JSON            |

## Doctor

Запустіть діагностику, щоб перевірити конфігурацію та підключення до API.

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

## Конфігурація

Керуйте конфігурацією CLI, що зберігається в `~/.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
```

Перегляньте [посібник із конфігурації](/uk/libraries/cli/configuration), щоб дізнатися про всі доступні ключі.

## Init

Запустіть інтерактивний майстер налаштування:

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

## Repl

Запустіть повноцінну інтерактивну командну оболонку:

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

## Формати виводу

Більшість команд для роботи з даними підтримують `--json` або `--format`:

```bash theme={null}
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
```

| Format     | Description                   |
| ---------- | ----------------------------- |
| `table`    | Розширена таблиця в терміналі |
| `json`     | Вивід JSON                    |
| `yaml`     | Вивід YAML                    |
| `csv`      | Значення, розділені комами    |
| `markdown` | Таблиця Markdown              |
