Перейти до основного вмісту
CometAPI CLI зчитує параметри з TOML config-файлу, змінних середовища та прапорців командного рядка. Якщо той самий параметр доступний з кількох джерел, порядок пріоритету такий: CLI flags > config file > environment variables > defaults

​
Config file

Розташування: ~/.config/cometapi/config.toml Запустіть майстер налаштування, щоб інтерактивно створити config-файл: 
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_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 автентифікує запити до model endpoints CometAPI. Створіть API key у CometAPI Console → API Keys. Вкажіть його одним із таких способів: 
export COMETAPI_KEY="<COMETAPI_KEY>"

​
Access token

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

​
Безпека

CLI застосовує такі практики безпеки:
  • API keys і токени доступу ніколи не журналюються та не відображаються повністю. У діагностичному виводі показуються лише останні 4 символи.
  • Config-файл створюється з обмежувальними правами доступу (0600) — читання доступне лише власнику файлу.
  • Облікові дані ніколи не слід додавати до системи контролю версій. За потреби додайте шлях до config-файлу у свій .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, щоб додати його