CometAPI CLI 會從 TOML 設定檔、環境變數與命令列旗標讀取設定。當同一個設定可從多個來源取得時,其優先順序如下:
CLI 旗標 > 設定檔 > 環境變數 > 預設值
設定檔
位置:~/.config/cometapi/config.toml
執行設定精靈,以互動方式建立設定檔:
或者使用 config 子命令管理個別設定:
可用設定
CLI 使用兩種類型的憑證:
API key
所有命令都需要。API key 用於驗證發送至 CometAPI 模型端點的請求。
在 CometAPI Console → API Keys 建立 API key。
可用以下其中一種方式設定:
Access token
選填。帳戶層級命令 account、stats、tokens、logs 與 tasks 需要 access token。
在 CometAPI Console → Personal Settings 產生 access token。
可用以下其中一種方式設定:
安全性
CLI 採用以下安全性實務:
- API key 與 access token 不會被記錄或完整顯示。診斷輸出中只會顯示最後 4 個字元。
- 設定檔會以限制性權限(
0600)建立——只有檔案擁有者可讀取。
- 憑證絕不應提交到版本控制。如果適用,請將設定檔路徑加入你的
.gitignore。
你需對使用你的 API key 所產生的所有用量與費用負責。請妥善保護你的金鑰,若懷疑有未經授權的存取,請輪替金鑰。
疑難排解