> ## Documentation Index > Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Справочник команд > Справочник по командам CometAPI CLI, включая chat, models, model info, run, balance, account, stats, tokens, logs, tasks, doctor, config и repl. Используйте `cometapi -h` или `cometapi -h`, чтобы посмотреть точные аргументы и опции для установленной версии. ## Обзор команд | Command | Description | Auth | | ----------------- | ------------------------------------------------------------------------- | ------------------------------- | | `chat [MESSAGE]` | Отправить сообщение в чат или запустить chat REPL | API key | | `models` | Вывести список и отфильтровать метаданные каталога моделей | API key | | `model info ` | Просмотреть общедоступные метаданные одной модели | 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`. Подробности см. в [руководстве по конфигурации](/ru/libraries/cli/configuration). ## Chat Отправьте одно сообщение или запустите многотуровый chat REPL. ```bash theme={null} 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 завершения. ```bash theme={null} 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`. ## Информация о модели Просмотрите общедоступные метаданные одной модели. Команда определяет модель через публичный каталог, затем загружает подробные метаданные для кода каталога. ```bash theme={null} 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. ```bash theme={null} 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. ```bash theme={null} 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. ```bash theme={null} cometapi account cometapi account --json ``` ## Stats Покажите статистику использования. Требуется access token. ```bash theme={null} cometapi stats cometapi stats --json ``` ## Tokens Список и поиск API key. Требуется access token. ```bash theme={null} cometapi tokens cometapi tokens --search project cometapi tokens --json ``` | Option | Short | Description | | ---------- | ----- | ------------------------- | | `--search` | `-s` | Ключевое слово для поиска | | `--page` | `-p` | Номер страницы | | `--limit` | `-l` | Результатов на страницу | | `--format` | `-f` | Формат вывода | | `--json` | | Вывести как JSON | ## Логи Просматривайте логи использования с фильтрами. Требуется токен доступа. ```bash theme={null} 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`. ## Задачи Показывает логи асинхронных задач. Требуется токен доступа. ```bash theme={null} 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. ```bash theme={null} cometapi doctor cometapi doctor --json ``` ## Config Управление конфигурацией CLI, хранящейся в `~/.config/cometapi/config.toml`. ```bash theme={null} 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 ``` См. [руководство по конфигурации](/ru/libraries/cli/configuration), чтобы узнать обо всех доступных ключах. ## Init Запустите интерактивный мастер настройки: ```bash theme={null} cometapi init ``` ## Repl Запустите полноценную интерактивную командную оболочку: ```bash theme={null} cometapi repl ``` ## Форматы вывода Большинство команд для работы с данными поддерживают `--json` или `--format`: ```bash theme={null} 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 |