Перейти к основному содержанию
CometAPI CLI — это официальный инструмент командной строки для взаимодействия с платформой CometAPI. Он поддерживает чат с несколькими моделями (Streaming и REPL), поиск моделей, запросы баланса и использования, просмотр логов и управление аккаунтом — всё из терминала. Начните со страницы пакета PyPI, если хотите получить актуальную команду установки, метаданные пакета и версию релиза в одном месте.
CometAPI CLI находится в beta. Ожидайте небольших изменений команд и UX, пока интерфейс CLI стабилизируется.

​
Возможности

  • Чат с несколькими моделями со Streaming и интерактивным REPL
  • Поиск и просмотр списка моделей
  • Баланс аккаунта и статистика использования
  • Просмотр логов использования с фильтрами и экспортом в CSV
  • Логи асинхронных задач (Suno, Midjourney, Kling и другие)
  • Вывод в нескольких форматах: table, JSON, YAML, CSV, Markdown
  • Конфигурация на основе TOML с мастером настройки
  • Автодополнение shell для Bash, Zsh и Fish
  • Дружественный к агентам дизайн со структурированным JSON-выводом и детерминированными кодами завершения

​
Предварительные требования

​
Установка

Используйте страницу пакета PyPI как основной источник по установке, затем выберите один из следующих способов для установки CLI: 
pip install cometapi-cli
Проверьте установку: 
cometapi --version

​
Быстрый старт

1

Запустите мастер настройки

Интерактивный мастер сохраняет ваш API key и необязательный access token в локальный файл конфигурации:
cometapi init
Мастер запрашивает:
  • API key — обязателен для всех команд. Создайте его в CometAPI Console → API Keys.
  • Access token — необязателен, нужен для команд account, stats, tokens, logs и tasks. Сгенерируйте его в Console → Personal Settings.
2

Начните чат с моделью

Отправьте одно сообщение с Streaming-выводом:
cometapi chat "Explain quantum computing in one sentence"
Переопределите модель по умолчанию:
cometapi chat "Hello!" --model claude-sonnet-4-6
3

Найдите доступные модели

Выведите список моделей, соответствующих ключевому слову:
cometapi models --search gemini --limit 10
4

Проверьте баланс

Посмотрите баланс аккаунта:
cometapi balance
Покажите представление биллинга для текущего API key:
cometapi balance --source key
5

Запустите диагностику

Проверьте, что CLI может подключиться к CometAPI:
cometapi doctor

​
Интерактивная сессия чата

Запустите cometapi chat без аргументов, чтобы войти в многошаговый чат REPL: 
cometapi chat
Команды REPL:
CommandDescription
/modelПереключить активную модель
/systemЗадать или изменить system prompt
/clearОчистить историю диалога
/historyПоказать историю диалога
/saveСохранить диалог в файл
/tokensПоказать использование Token за сессию
/helpПоказать все команды REPL
/exitВыйти из REPL

​
Интеграция с агентами

CLI предназначен для использования AI coding agents и скриптами автоматизации:
  • Все команды данных поддерживают --json для структурированного, машиночитаемого вывода
  • Детерминированные коды завершения: 0 (успех), 64 (отсутствует конфигурация), 77 (ошибка аутентификации), 69 (сервис недоступен)
  • Ошибки выводятся в stderr, данные — в stdout
  • Смотрите полный справочник команд с параметрами для каждой команды

​
Ссылки