跳轉到主要內容
CometAPI CLI 是一款用於與 CometAPI 平台互動的官方命令列工具。它支援多模型聊天（串流與 REPL）、模型搜尋、餘額與使用量查詢、記錄瀏覽，以及帳戶管理——全都可直接在終端機中完成。 如果您想在同一個地方取得最新的安裝指令、套件中繼資料與發行版本，請從 PyPI 套件頁面 開始。
CometAPI CLI 目前為 beta 版。在 CLI 介面穩定下來之前，指令與使用體驗可能會有些小幅變動。

​
功能

  • 支援串流與互動式 REPL 的多模型聊天
  • 模型搜尋與列表檢視
  • 帳戶餘額與使用統計
  • 支援篩選與 CSV 匯出的使用記錄瀏覽
  • 非同步任務記錄（Suno、Midjourney、Kling 等）
  • 多種輸出格式：table、JSON、YAML、CSV、Markdown
  • 基於 TOML 的設定與安裝精靈
  • Bash、Zsh 與 Fish 的 shell 補全
  • 對 agent 友善的設計，具備結構化 JSON 輸出與可預測的 exit code

​
先決條件

​
安裝

請將 PyPI 套件頁面 作為主要的安裝參考，然後選擇以下其中一種方式安裝 CLI： 
pip install cometapi-cli
驗證安裝是否成功： 
cometapi --version

​
快速開始

1

執行設定精靈

互動式精靈會將您的 API key 與選用的 access token 儲存在本機設定檔中：
cometapi init
精靈會提示您輸入：
2

與模型聊天

傳送單一訊息並使用串流輸出：
cometapi chat "Explain quantum computing in one sentence"
覆寫預設模型：
cometapi chat "Hello!" --model claude-sonnet-4-6
3

搜尋可用模型

列出符合關鍵字的模型：
cometapi models --search gemini --limit 10
4

檢查您的餘額

檢視您的帳戶餘額：
cometapi balance
顯示目前 API key 的計費檢視：
cometapi balance --source key
5

執行診斷

驗證 CLI 是否可以連線到 CometAPI：
cometapi doctor

​
互動式聊天工作階段

執行不帶參數的 cometapi chat 以進入多輪聊天 REPL： 
cometapi chat
REPL 指令：
CommandDescription
/model切換目前使用中的模型
/system設定或變更 system prompt
/clear清除對話歷史
/history顯示對話歷史
/save將對話儲存至檔案
/tokens顯示此工作階段的 token 使用量
/help列出所有 REPL 指令
/exit離開 REPL

​
Agent 整合

CLI 是為 AI 程式設計代理與自動化指令碼而設計：
  • 所有資料指令都支援 --json，可提供結構化、機器可讀的輸出
  • 可預測的結束代碼：0（成功）、64（缺少設定）、77（驗證錯誤）、69（服務無法使用）
  • 錯誤輸出到 stderr，資料輸出到 stdout
  • 各指令選項請參閱完整的指令參考

​
連結