Перейти до основного вмісту
CometAPI CLI — це офіційний інструмент командного рядка для взаємодії з платформою CometAPI. Він підтримує багатомодельний чат (streaming і REPL), пошук моделей, запити балансу та використання, перегляд журналів і керування обліковим записом — усе з термінала. Почніть зі сторінки пакета PyPI, якщо хочете отримати актуальну команду встановлення, метадані пакета та версію релізу в одному місці.
CometAPI CLI перебуває на стадії beta. Очікуйте невеликих змін у командах і 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

Спілкуйтеся з моделлю

Надішліть одне повідомлення з виведенням у режимі 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:
КомандаОпис
/modelПеремкнути активну модель
/systemУстановити або змінити system prompt
/clearОчистити історію розмови
/historyПоказати історію розмови
/saveЗберегти розмову у файл
/tokensПоказати використання token за сесію
/helpПерелічити всі команди REPL
/exitВийти з REPL

Інтеграція з агентами

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

Посилання