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.
Обзор команд
| 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 |
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 | System 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 key. Требуется 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 key |
--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
Показать журналы асинхронных задач для таких платформ, как Midjourney, Luma и Kling. Требуется access token.
# 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 | | Фильтр по названию платформы |
--status | | Фильтр по статусу |
--limit | -l | Максимальное количество записей |
--format | -f | Формат вывода |
--json | | Вывод в формате JSON |
Doctor
Запустите диагностику, чтобы проверить конфигурацию CLI и доступность API.
cometapi doctor
cometapi doctor --json
- Наличие файла конфигурации и возможность его чтения
- Наличие API key и его источник (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 key и access token.
Мастер записывает настройки в ~/.config/cometapi/config.toml.
Repl
Запустите полноценную интерактивную командную оболочку, в которой можно выполнять любые команды CLI без префикса cometapi.
Форматы вывода
Все команды данных поддерживают --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 |
cometapi config set output_format json
Автодополнение оболочки
Установите автодополнение командной оболочки для поддержки tab-complete:
cometapi --install-completion
Коды выхода
| Code | Meaning |
|---|
0 | Успех |
1 | Общая ошибка |
2 | Недопустимые аргументы |
64 | Отсутствует конфигурация |
69 | Сервис недоступен |
77 | Ошибка аутентификации |
