Справочник команд

Используйте 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`	Запустить интерактивную командную оболочку	Зависит от используемой команды

Команды, помеченные как 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`	System prompt
`--temperature`	`-t`	Температура сэмплирования
`--max-tokens`		Максимальное количество Tokens в ответе
`--stream/--no-stream`		Включить или отключить Streaming
`--format`	`-f`	Формат вывода
`--json`		Вывод в формате JSON

Models

По умолчанию выводит список моделей из публичного каталога. Вывод каталога включает model ID, provider, тип модели, возможности, endpoints, цены, длину контекста и максимальное число 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

Option	Short	Description
`--refresh`		Обновить кэш каталога перед поиском
`--no-cache`		Обойти кэш каталога для этой команды
`--format`	`-f`	Формат вывода
`--json`		Вывести необработанный JSON с подробной информацией о модели

Вывод в виде таблицы включает провайдера, тип модели, возможности, endpoints, стоимость, длину контекста, максимальное число completion tokens, URL документации и обзор.

Run

Отправьте один запрос через выбранный формат endpoint. Используйте --input-file для JSON-тела, повторяющиеся значения -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

Option	Short	Description
`--endpoint`	`-e`	Формат endpoint: `chat`, `responses`, `anthropic` или `gemini`
`--input-file`		JSON-объект тела запроса
`--input`	`-i`	Входные данные запроса в виде `key=value`; можно повторять для нескольких значений
`--prompt`	`-p`	Сокращение для Prompt
`--json`		Вывести необработанный JSON-ответ

Сопоставление endpoint:

Endpoint	Request path	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`

Порядок объединения тела: --input-file, повторяющиеся -i key=value, сокращение Prompt, затем позиционный MODEL. Встроенные значения по возможности разбираются как JSON. Ключи с точками создают вложенные объекты.

Balance

Покажите баланс вашего аккаунта CometAPI или текущий вид биллинга API key.

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

Option	Short	Description
`--source`	`-s`	Источник данных: `account` или `key`
`--format`	`-f`	Формат вывода
`--json`		Вывести как JSON

Account

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

cometapi account
cometapi account --json

Stats

Покажите статистику использования. Требуется access token.

cometapi stats
cometapi stats --json

Tokens

Список и поиск API key. Требуется access token.

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

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

Логи

Просматривайте логи использования с фильтрами. Требуется токен доступа.

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`		Вывод CSV с сервера в stdout
`--format`	`-f`	Формат вывода
`--json`		Вывод в формате JSON

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

Задачи

Показывает логи асинхронных задач. Требуется токен доступа.

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

Config

Управление конфигурацией 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

Информация о модели

Run

Balance

Account

Stats

Tokens

Логи

Задачи

Doctor

Config

Init

Repl

Форматы вывода

​Обзор команд

​Chat

​Models

​Информация о модели

​Run

​Balance

​Account

​Stats

​Tokens

​Логи

​Задачи

​Doctor

​Config

​Init

​Repl

​Форматы вывода

Обзор команд

Chat

Models

Информация о модели

Run

Balance

Account

Stats

Tokens

Логи

Задачи

Doctor

Config

Init

Repl

Форматы вывода