Перейти к основному содержанию
CometAPI CLI читает настройки из TOML-файла конфигурации, переменных окружения и флагов командной строки. Если один и тот же параметр доступен из нескольких источников, используется следующий порядок приоритета: Флаги CLI > файл конфигурации > переменные окружения > значения по умолчанию

​
Файл конфигурации

Расположение: ~/.config/cometapi/config.toml Запустите мастер настройки, чтобы интерактивно создать файл конфигурации: 
cometapi init
Или управляйте отдельными параметрами с помощью подкоманды config: 
# View current configuration
cometapi config show

# Set a value
cometapi config set api_key sk-...

# Remove a value
cometapi config unset api_key

# Show the config file path
cometapi config path

​
Доступные параметры

Ключ конфигурацииПеременная окруженияОписание
api_keyCOMETAPI_KEYAPI key (обязателен для всех команд)
access_tokenCOMETAPI_ACCESS_TOKENТокен доступа для команд уровня аккаунта
base_urlCOMETAPI_BASE_URLБазовый URL API (по умолчанию: https://api.cometapi.com/v1)
default_modelCOMETAPI_DEFAULT_MODELМодель по умолчанию для chat (резервное значение: gpt-5.4)
output_format—Формат вывода по умолчанию: table, json, yaml, csv или markdown

​
Учетные данные

CLI использует два типа учетных данных:

​
API key

Обязателен для всех команд. API key используется для аутентификации запросов к endpoint’ам моделей CometAPI. Создайте API key в CometAPI Console → API Keys. Установите его одним из следующих способов: 
export COMETAPI_KEY="<COMETAPI_KEY>"

​
Токен доступа

Необязателен. Токен доступа требуется для команд уровня аккаунта: account, stats, tokens, logs и tasks. Сгенерируйте токен доступа в CometAPI Console → Personal Settings. Установите его одним из следующих способов: 
export COMETAPI_ACCESS_TOKEN="your-access-token"

​
Безопасность

CLI применяет следующие практики безопасности:
  • API keys и токены доступа никогда не логируются и не отображаются полностью. В диагностическом выводе показываются только последние 4 символа.
  • Файл конфигурации создается с ограниченными правами доступа (0600) — его может читать только владелец файла.
  • Учетные данные никогда не следует коммитить в систему контроля версий. При необходимости добавьте путь к файлу конфигурации в ваш .gitignore.
Вы несете ответственность за все использование и расходы, связанные с вашими API keys. Храните ключи в безопасности и заменяйте их, если подозреваете несанкционированный доступ.

​
Устранение неполадок

ОшибкаРешение
API key not configuredЗапустите cometapi init или задайте переменную окружения COMETAPI_KEY
Connection failedЗапустите cometapi doctor для диагностики подключения
Access token not configuredНужен только для account/stats/tokens/logs/tasks. Запустите cometapi init, чтобы добавить его