Chuyển đến nội dung chính
CometAPI CLI đọc các thiết lập từ file config TOML, biến môi trường và cờ dòng lệnh. Khi cùng một thiết lập có sẵn từ nhiều nguồn, thứ tự ưu tiên là: Cờ CLI > file config > biến môi trường > mặc định

​
File config

Vị trí: ~/.config/cometapi/config.toml Chạy trình hướng dẫn thiết lập để tạo file config một cách tương tác: 
cometapi init
Hoặc quản lý từng thiết lập riêng lẻ bằng subcommand 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

​
Các thiết lập khả dụng

Config keyEnvironment variableMô tả
api_keyCOMETAPI_KEYAPI key (bắt buộc cho mọi lệnh)
access_tokenCOMETAPI_ACCESS_TOKENAccess token cho các lệnh cấp tài khoản
base_urlCOMETAPI_BASE_URLURL cơ sở của API (mặc định: https://api.cometapi.com/v1)
default_modelCOMETAPI_DEFAULT_MODELmodel mặc định cho chat (dự phòng: gpt-5.4)
output_format—Định dạng đầu ra mặc định: table, json, yaml, csv, hoặc markdown

​
Thông tin xác thực

CLI sử dụng hai loại thông tin xác thực:

​
API key

Bắt buộc cho mọi lệnh. API key dùng để xác thực các request tới các endpoint model của CometAPI. Tạo một API key tại CometAPI Console → API Keys. Thiết lập bằng một trong các cách sau: 
export COMETAPI_KEY="<COMETAPI_KEY>"

​
Access token

Tùy chọn. Access token là bắt buộc cho các lệnh cấp tài khoản: account, stats, tokens, logs, và tasks. Tạo access token tại CometAPI Console → Personal Settings. Thiết lập bằng một trong các cách sau: 
export COMETAPI_ACCESS_TOKEN="your-access-token"

​
Bảo mật

CLI áp dụng các thực hành bảo mật sau:
  • API key và access token không bao giờ được ghi log hoặc hiển thị đầy đủ. Chỉ 4 ký tự cuối được hiển thị trong đầu ra chẩn đoán.
  • File config được tạo với quyền hạn chế (0600) — chỉ chủ sở hữu file mới có thể đọc.
  • Thông tin xác thực không bao giờ nên được commit vào version control. Hãy thêm đường dẫn file config vào .gitignore nếu phù hợp.
Bạn chịu trách nhiệm cho mọi mức sử dụng và chi phí phát sinh với các API key của mình. Hãy giữ key an toàn và thay vòng chúng nếu bạn nghi ngờ có truy cập trái phép.

​
Khắc phục sự cố

ErrorSolution
API key not configuredChạy cometapi init hoặc thiết lập biến môi trường COMETAPI_KEY
Connection failedChạy cometapi doctor để chẩn đoán kết nối
Access token not configuredChỉ cần cho account/stats/tokens/logs/tasks. Chạy cometapi init để thêm