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

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

  • Чат с несколькими моделями с поддержкой streaming и интерактивного REPL
  • Поиск и просмотр списка моделей
  • Баланс аккаунта и статистика использования
  • Просмотр логов использования с фильтрами и экспортом в CSV
  • Логи асинхронных задач (Suno, Midjourney, Kling и другие)
  • Вывод в нескольких форматах: table, JSON, YAML, CSV, Markdown
  • Конфигурация на основе TOML с мастером настройки
  • Автодополнение команд для 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

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

Отправьте одно сообщение с потоковым выводом:
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Установить или изменить системный prompt
/clearОчистить историю разговора
/historyПоказать историю разговора
/saveСохранить разговор в файл
/tokensПоказать использование token за сессию
/helpПоказать все команды REPL
/exitВыйти из REPL

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

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

​
Ссылки