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

Огляд команд

Command	Description	Auth
`chat [MESSAGE]`	Надіслати повідомлення або запустити інтерактивний REPL	API key
`models`	Переглянути список і виконати пошук доступних моделей	API key
`balance`	Показати баланс акаунта	API key (або access token)
`account`	Показати профіль акаунта	Access token
`stats`	Показати статистику використання	Access token
`tokens`	Переглянути список і виконати пошук ваших API key	Access token
`logs`	Переглядати журнали використання з фільтрами	Access token
`tasks`	Показати журнали асинхронних задач	Access token
`init`	Інтерактивний майстер налаштування	—
`doctor`	Запустити діагностику та перевірки стану	API key
`config`	Керувати конфігурацією CLI	—
`repl`	Запустити інтерактивну командну оболонку	API key

Команди, позначені як Access token, потребують змінної середовища COMETAPI_ACCESS_TOKEN або ключа конфігурації access_token. Докладніше дивіться в посібнику з конфігурації.

Chat

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

Models

Перегляньте доступні моделі з необов’язковим пошуком і обмеженням кількості.

# 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`	Фільтрувати моделі за ключовим словом
`--limit`	`-l`	Максимальна кількість результатів
`--format`	`-f`	Формат виводу
`--json`		Виводити як JSON

Balance

Показати баланс вашого акаунта 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`	Джерело даних: `account` (увесь акаунт) або `key` (поточний API key).
`--format`	`-f`	Формат виводу
`--json`		Виводити як JSON

Account

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

cometapi account
cometapi account --json

Option	Short	Description
`--format`	`-f`	Формат виводу
`--json`		Виводити як JSON

Stats

Показати статистику використання за поточний місяць. Потрібен access token.

cometapi stats
cometapi stats --json

Вивід містить: кількість запитів, обсяг використання, рівень успішності та прогнозовану кількість днів до вичерпання балансу.

Option	Short	Description
`--format`	`-f`	Формат виводу
`--json`		Виводити як JSON

Tokens

Переглядайте список і виконуйте пошук своїх API-ключів. Потрібен access token.

# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json

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

Logs

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

# 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`	Фільтр за model ID
`--token-name`		Фільтр за назвою API-ключа
`--type`	`-t`	Тип журналу: `consume`, `topup`, `error`, `refund`, `system`, `manage`
`--start`		Дата початку (YYYY-MM-DD)
`--end`		Дата завершення (YYYY-MM-DD)
`--group`	`-g`	Фільтр за групою
`--limit`	`-l`	Максимальна кількість записів
`--page`	`-p`	Номер сторінки
`--page-size`		Результатів на сторінку
`--export`		Вивести як CSV у stdout
`--format`	`-f`	Формат виводу
`--json`		Виводити як JSON

Tasks

Показуйте журнали асинхронних задач для таких платформ, як Suno, Midjourney, Luma і Kling. Потрібен access token.

# 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`		Фільтр за назвою платформи
`--status`		Фільтр за статусом
`--limit`	`-l`	Максимальна кількість записів
`--format`	`-f`	Формат виводу
`--json`		Виводити як JSON

Doctor

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

cometapi doctor
cometapi doctor --json

Doctor перевіряє:

Наявність і доступність для читання файла конфігурації
Наявність API-ключа та його джерело (config, env або відсутній)
Наявність access token
Мережеве з’єднання з endpoint CometAPI
Валідність автентифікації API

Option	Short	Description
`--format`	`-f`	Формат виводу
`--json`		Виводити як JSON

Config

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

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

Init

Запустіть інтерактивний майстер налаштування, щоб налаштувати ваш API-ключ і access token.

cometapi init

Майстер записує налаштування до ~/.config/cometapi/config.toml.

Repl

Запустіть повноцінну інтерактивну командну оболонку, у якій можна виконувати будь-яку CLI-команду без префікса cometapi.

cometapi repl

Output formats

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

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

Встановіть формат за замовчуванням для всіх команд через config:

cometapi config set output_format json

Shell completion

Установіть автодоповнення для оболонки, щоб увімкнути підтримку завершення за Tab:

cometapi --install-completion

Підтримувані оболонки: Bash, Zsh, Fish.

Коди завершення

Code	Значення
`0`	Успіх
`1`	Загальна помилка
`2`	Недійсні аргументи
`64`	Відсутня конфігурація
`69`	Сервіс недоступний
`77`	Помилка автентифікації

Огляд

Довідник API

Посібники з інтеграції

Інструменти розробника

Помилки

Ціни та оплата

Підтримка

Огляд команд

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

Shell completion

Коди завершення

Огляд

Довідник API

Посібники з інтеграції

Інструменти розробника

Помилки

Ціни та оплата

Підтримка

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

​Chat

​Models

​Balance

​Account

​Stats

​Tokens

​Logs

​Tasks

​Doctor

​Config

​Init

​Repl

​Output formats

​Shell completion

​Коди завершення

Огляд команд

Chat

Models

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

Shell completion

Коди завершення