Довідник команд

Використовуйте cometapi -h або cometapi <command> -h, щоб переглянути точні аргументи й опції для встановленої версії.

Огляд команд

Command	Description	Auth
`chat [MESSAGE]`	Надіслати повідомлення в чат або запустити chat REPL	API key
`models`	Переглянути та відфільтрувати метадані каталогу моделей	API key
`model info <id>`	Переглянути публічні метадані однієї моделі	API key
`run [MODEL]`	Надіслати один запит у форматах chat, responses, anthropic або gemini	API key
`balance`	Показати баланс акаунта або поточного API key	API key or access token
`account`	Показати профіль акаунта	Access token
`stats`	Показати статистику використання	Access token
`tokens`	Переглянути та знайти API key	Access token
`logs`	Переглядати журнали використання з фільтрами	Access token
`tasks`	Показати журнали асинхронних завдань	Access token
`init`	Запустити майстер налаштування	None
`doctor`	Запустити діагностику	API key
`config`	Керувати локальною конфігурацією	None
`repl`	Запустити інтерактивну командну оболонку	Depends on command used

Для команд, позначених Access token, потрібна змінна середовища COMETAPI_ACCESS_TOKEN або ключ конфігурації access_token. Докладніше дивіться в посібнику з конфігурації.

Chat

Надішліть одне повідомлення або запустіть багатоходовий chat REPL.

cometapi chat "Explain CometAPI in one sentence."
cometapi chat "Summarize this" --model your-model-id --system "Be concise."
cometapi chat "Hello" --no-stream
cometapi chat "Hello" --json
cometapi chat

Option	Short	Description
`--model`	`-m`	Модель для використання
`--system`	`-s`	Системний Prompt
`--temperature`	`-t`	Температура семплювання
`--max-tokens`		Максимальна кількість response Tokens
`--stream/--no-stream`		Увімкнути або вимкнути Streaming
`--format`	`-f`	Формат виводу
`--json`		Вивести як JSON

Models

За замовчуванням показує моделі з публічного каталогу. Вивід каталогу містить model ID, provider, model type, features, endpoints, pricing, context length і maximum completion tokens.

cometapi models
cometapi models --search gpt --limit 10
cometapi models --provider openai --type chat --limit 10
cometapi models --feature image --endpoint responses --json
cometapi models --refresh
cometapi models --source openai --search gpt

Option	Short	Description
`--search`	`-s`	Фільтрувати за ID, кодом, назвою, описом або provider
`--provider`		Фільтрувати за назвою або кодом provider
`--type`, `--modality`		Фільтрувати за типом моделі або modality
`--feature`, `--capability`		Фільтрувати за feature або capability
`--endpoint`		Фільтрувати за назвою endpoint, методом або шляхом
`--limit`	`-l`	Максимальна кількість результатів
`--source`		Використовувати метадані `catalog` або OpenAI-сумісний список `openai`
`--refresh`		Оновити одногодинний кеш каталогу
`--no-cache`		Обійти кеш каталогу для цієї команди
`--format`	`-f`	Формат виводу
`--json`		Вивести як JSON

Кеш каталогу зберігається в ~/.cache/cometapi/models.json.

Інформація про модель

Перегляньте публічні метадані для однієї моделі. Команда визначає модель через публічний каталог, а потім завантажує детальні метадані для коду каталогу.

cometapi model info your-model-id
cometapi model info your-model-id --json
cometapi model info your-model-id --refresh

Параметр	Коротко	Опис
`--refresh`		Оновити кеш каталогу перед пошуком
`--no-cache`		Обійти кеш каталогу для цієї команди
`--format`	`-f`	Формат виводу
`--json`		Вивести необроблений JSON із деталями моделі

Табличний вивід містить provider, тип моделі, features, endpoints, pricing, довжину контексту, максимальну кількість completion tokens, URL документації та огляд.

Виконання

Надішліть один запит через вибраний формат endpoint. Використовуйте --input-file для JSON body, повторювані значення -i key=value для перевизначень і -p/--prompt як скорочення для prompt.

cometapi run your-model-id -p "Write one sentence about CometAPI."
cometapi run your-model-id --endpoint responses -p "Reply with OK only." -i max_output_tokens=32 --json
cometapi run your-model-id --endpoint anthropic -p "Reply with OK only." -i max_tokens=32
cometapi run your-model-id --endpoint gemini -p "Reply with OK only." -i generationConfig.maxOutputTokens=32
cometapi run your-model-id --endpoint responses --input-file body.json -i temperature=0.2 --json

Параметр	Коротко	Опис
`--endpoint`	`-e`	Формат endpoint: `chat`, `responses`, `anthropic` або `gemini`
`--input-file`		JSON object request body
`--input`	`-i`	Вхідні дані запиту у форматі `key=value`; повторіть для кількох значень
`--prompt`	`-p`	Скорочення для prompt
`--json`		Вивести необроблену JSON-відповідь

Відображення endpoint:

Endpoint	Шлях запиту	Auth
`chat`	`POST /v1/chat/completions`	Bearer API key
`responses`	`POST /v1/responses`	Bearer API key
`anthropic`	`POST /v1/messages`	API key `x-api-key` і заголовок версії Anthropic
`gemini`	Шлях моделі Gemini Generate Content	API key `x-goog-api-key`

Порядок злиття body: --input-file, повторювані -i key=value, скорочення для prompt, потім позиційний MODEL. Вбудовані значення аналізуються як JSON, коли це можливо. Ключі з крапками створюють вкладені об’єкти.

Баланс

Покажіть баланс вашого облікового запису CometAPI або поточне представлення білінгу API key.

cometapi balance
cometapi balance --source account
cometapi balance --source key
cometapi balance --json

Параметр	Коротко	Опис
`--source`	`-s`	Джерело даних: `account` або `key`
`--format`	`-f`	Формат виводу
`--json`		Вивести як JSON

Обліковий запис

Покажіть профіль вашого облікового запису. Потрібен access token.

cometapi account
cometapi account --json

Статистика

Покажіть статистику використання. Потрібен access token.

cometapi stats
cometapi stats --json

Tokens

Перелічіть і знайдіть API keys. Потрібен access token.

cometapi tokens
cometapi tokens --search project
cometapi tokens --json

Параметр	Коротко	Опис
`--search`	`-s`	Ключове слово для пошуку
`--page`	`-p`	Номер сторінки
`--limit`	`-l`	Результатів на сторінку
`--format`	`-f`	Формат виводу
`--json`		Вивести як JSON

Журнали

Переглядайте журнали використання з фільтрами. Потрібен access token.

cometapi logs
cometapi logs --model your-model-id
cometapi logs --start 2026-04-01 --end 2026-04-14
cometapi logs --type consume
cometapi logs --export > usage.csv
cometapi logs --limit 50 --json
cometapi logs --request-id 20260617165550885561292gJBlzjtp

Option	Short	Description
`--model`	`-m`	Фільтрувати за model ID
`--token-name`	`-t`	Фільтрувати за назвою API key
`--type`		Тип журналу
`--search`	`-s`	Ключове слово для пошуку
`--start`		Дата початку
`--end`		Дата завершення
`--group`	`-g`	Фільтрувати за групою API key
`--request-id`		Знайти один запит за `X-Cometapi-Request-Id`
`--page`	`-p`	Номер сторінки
`--limit`	`-l`	Результатів на сторінку
`--export`		Вивести server-side CSV у stdout
`--format`	`-f`	Формат виводу
`--json`		Вивести як JSON

logs --request-id виконує один індексований пошук через endpoint журналу оператора і приймає лише точний збіг request_id. CLI не сканує резервні сторінки журналів, оскільки endpoint self-log не застосовує фільтрацію за request_id.

Завдання

Показати журнали асинхронних завдань. Потрібен access token.

cometapi tasks
cometapi tasks --platform kling
cometapi tasks --status SUCCESS
cometapi tasks --json

Option	Short	Description
`--platform`	`-p`	Фільтрувати за платформою
`--task-id`		Фільтрувати за ID завдання
`--status`	`-s`	Фільтрувати за статусом
`--action`	`-a`	Фільтрувати за типом дії
`--start`		Дата початку
`--end`		Дата завершення
`--page`		Номер сторінки
`--limit`	`-l`	Результатів на сторінку
`--format`	`-f`	Формат виводу
`--json`		Вивести як JSON

Doctor

Запустіть діагностику, щоб перевірити конфігурацію та підключення до API.

cometapi doctor
cometapi doctor --json

Конфігурація

Керуйте конфігурацією CLI, що зберігається в ~/.config/cometapi/config.toml.

cometapi config show
cometapi config set api_key "$COMETAPI_KEY"
cometapi config set default_model your-model-id
cometapi config unset api_key
cometapi config path

Перегляньте посібник із конфігурації, щоб дізнатися про всі доступні ключі.

Init

Запустіть інтерактивний майстер налаштування:

cometapi init

Repl

Запустіть повноцінну інтерактивну командну оболонку:

cometapi repl

Формати виводу

Більшість команд для роботи з даними підтримують --json або --format:

cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown

Format	Description
`table`	Розширена таблиця в терміналі
`json`	Вивід JSON
`yaml`	Вивід YAML
`csv`	Значення, розділені комами
`markdown`	Таблиця Markdown

Почніть тут

Швидкий старт з API моделей

Основні посібники з API

Бібліотеки

Помилки

Ціни та виставлення рахунків

Підтримка

Огляд команд

Chat

Models

Інформація про модель

Виконання

Баланс

Обліковий запис

Статистика

Tokens

Журнали

Завдання

Doctor

Конфігурація

Init

Repl

Формати виводу

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

​Chat

​Models

​Інформація про модель

​Виконання

​Баланс

​Обліковий запис

​Статистика

​Tokens

​Журнали

​Завдання

​Doctor

​Конфігурація

​Init

​Repl

​Формати виводу

Огляд команд

Chat

Models

Інформація про модель

Виконання

Баланс

Обліковий запис

Статистика

Tokens

Журнали

Завдання

Doctor

Конфігурація

Init

Repl

Формати виводу