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

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

Надішліть одне повідомлення з потоковим виводом:
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 агентами для програмування та сценаріями автоматизації:
  • Усі команди даних підтримують --json для структурованого, придатного для машинного читання виводу
  • Детерміновані коди виходу: 0 (успіх), 64 (відсутня конфігурація), 77 (помилка автентифікації), 69 (сервіс недоступний)
  • Помилки спрямовуються в stderr, дані — у stdout
  • Перегляньте повний довідник команд, щоб дізнатися про параметри окремих команд

​
Посилання