Перейти к основному содержанию
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

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

Config keyEnvironment variableDescription
api_keyCOMETAPI_KEYAPI key (обязателен для всех команд)
access_tokenCOMETAPI_ACCESS_TOKENAccess 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>"

​
Access token

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

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

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

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

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