跳轉到主要內容

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 會從 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帳戶層級命令所需的 access token
base_urlCOMETAPI_BASE_URLAPI 基底 URL（預設：https://api.cometapi.com/v1）
default_modelCOMETAPI_DEFAULT_MODELchat 的預設 model（後備值：gpt-5.4）
output_format—預設輸出格式：table、json、yaml、csv 或 markdown

​
憑證

CLI 使用兩種類型的憑證：

​
API key

所有命令皆需要。API key 用於驗證對 CometAPI 模型端點發出的請求。 請在 CometAPI Console → API Keys 建立 API key。 可用以下其中一種方式設定： 
read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY

​
Access token

選用。帳戶層級命令需要 access token：account、stats、tokens、logs 與 tasks。 請在 CometAPI Console → Personal Settings 產生 access token。 可用以下其中一種方式設定： 
export COMETAPI_ACCESS_TOKEN="your-access-token"

​
安全性

CLI 會採用以下安全性實務：
  • API key 與 access token 絕不會被完整記錄或顯示。診斷輸出中只會顯示最後 4 個字元。
  • 設定檔會以嚴格權限 (0600) 建立——只有檔案擁有者可讀取。
  • 憑證絕不應提交到版本控制。如果適用，請將設定檔路徑加入你的 .gitignore。
你需對使用你的 API key 所產生的所有用量與費用負責。請妥善保管你的金鑰，若懷疑有未經授權的存取，請輪替金鑰。

​
疑難排解

錯誤解決方案
API key not configured執行 cometapi init 或設定 COMETAPI_KEY 環境變數
Connection failed執行 cometapi doctor 以診斷連線問題
Access token not configured僅 account/stats/tokens/logs/tasks 需要。執行 cometapi init 來新增一個