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

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

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-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
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-ключей. Требуется 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-ключа
--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-ключа и его источник (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-ключ и 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

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

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

​
Коды выхода

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