Перейти к основному содержанию

​
Обзор команд

CommandDescriptionAuth
chat [MESSAGE]Отправить сообщение или запустить интерактивный REPLAPI key
modelsВывести список и выполнить поиск доступных моделейAPI key
balanceПоказать баланс аккаунтаAPI key (или access token)
accountПоказать профиль аккаунтаAccess token
statsПоказать статистику использованияAccess token
tokensВывести список и выполнить поиск ваших API keyAccess 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
OptionShortDescription
--model-mМодель для использования (по умолчанию: из конфигурации)
--system-sSystem 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
OptionShortDescription
--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
OptionShortDescription
--source-sИсточник данных: account (весь аккаунт) или key (текущий API key).
--format-fФормат вывода
--jsonВывод в формате JSON

​
Account

Показать профиль вашего аккаунта. Требуется access token. 
cometapi account
cometapi account --json
OptionShortDescription
--format-fФормат вывода
--jsonВывод в формате JSON

​
Stats

Показать статистику использования за текущий месяц. Требуется access token. 
cometapi stats
cometapi stats --json
Вывод включает: количество запросов, объем использования, процент успешных запросов и прогнозируемое количество дней до исчерпания баланса.
OptionShortDescription
--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
OptionShortDescription
--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
OptionShortDescription
--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

Показать журналы асинхронных задач для таких платформ, как 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
OptionShortDescription
--platformФильтр по названию платформы
--statusФильтр по статусу
--limit-lМаксимальное количество записей
--format-fФормат вывода
--jsonВывод в формате JSON

​
Doctor

Запустите диагностику, чтобы проверить конфигурацию CLI и доступность API. 
cometapi doctor
cometapi doctor --json
Doctor проверяет:
  • Наличие файла конфигурации и возможность его чтения
  • Наличие API key и его источник (config, env или отсутствует)
  • Наличие access token
  • Сетевую доступность endpoint CometAPI
  • Корректность аутентификации API
OptionShortDescription
--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. 
cometapi init
Мастер записывает настройки в ~/.config/cometapi/config.toml.

​
Repl

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

​
Форматы вывода

Все команды данных поддерживают --json или --format: 
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
FormatDescription
tableБогатая таблица в терминале (по умолчанию)
jsonВывод JSON
yamlВывод YAML
csvЗначения, разделенные запятыми
markdownТаблица Markdown
Установите формат по умолчанию для всех команд через config: 
cometapi config set output_format json

​
Автодополнение оболочки

Установите автодополнение командной оболочки для поддержки tab-complete: 
cometapi --install-completion
Поддерживаемые оболочки: Bash, Zsh, Fish.

​
Коды выхода

CodeMeaning
0Успех
1Общая ошибка
2Недопустимые аргументы
64Отсутствует конфигурация
69Сервис недоступен
77Ошибка аутентификации