Перейти до основного вмісту

​
Огляд команд

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-sSystem 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 key. Потрібен 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 key
--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 key і його джерело (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 key і 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

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

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

​
Коди виходу

CodeMeaning
0Успіх
1Загальна помилка
2Неприпустимі аргументи
64Відсутня конфігурація
69Сервіс недоступний
77Помилка автентифікації