跳轉到主要內容

​
命令總覽

CommandDescriptionAuth
chat [MESSAGE]傳送訊息或啟動互動式 REPLAPI key
models列出並搜尋可用模型API key
balance顯示帳戶餘額API key（或 access token）
account顯示帳戶個人資料Access token
stats顯示使用統計Access token
tokens列出並搜尋你的 API keyAccess token
logs使用篩選條件瀏覽使用記錄Access token
tasks顯示非同步任務記錄Access token
init互動式設定精靈—
doctor執行診斷與健康檢查API key
config管理 CLI 設定—
repl啟動互動式命令 shellAPI key
標示為 Access token 的命令需要 COMETAPI_ACCESS_TOKEN 環境變數或 access_token 設定鍵。詳細資訊請參閱設定指南。

​
Chat

傳送單一訊息，或啟動多輪互動式 REPL。 
# Single message (streaming by default)
cometapi chat "Explain quantum computing in one sentence"

# Override model and add a system prompt
cometapi chat "Summarize this" --model claude-sonnet-4-6 --system "Be concise"

# Disable streaming
cometapi chat "Hello" --no-stream

# JSON output (full API response)
cometapi chat "Hello" --json

# Interactive REPL (omit message)
cometapi chat
OptionShortDescription
--model-m要使用的模型（預設：來自設定）
--system-s系統 Prompt
--temperature-t取樣溫度（0.0–2.0）
--max-tokens回應中的最大 tokens
--stream/--no-stream啟用或停用串流（Streaming）（預設：stream）
--format-f輸出格式
--json以 JSON 輸出

​
Models

列出可用模型，並可選擇搜尋與限制數量。 
# List all models
cometapi models

# Search by keyword
cometapi models --search gemini

# Limit results and output as JSON
cometapi models --search gpt --limit 10 --json
OptionShortDescription
--search-s依關鍵字篩選模型
--limit-l結果的最大數量
--format-f輸出格式
--json以 JSON 輸出

​
Balance

顯示你的 CometAPI 帳戶餘額。 
# Default: account-level balance (falls back to per-key billing)
cometapi balance

# Force account-level view
cometapi balance --source account

# Force API key billing view
cometapi balance --source key

# JSON output
cometapi balance --json
OptionShortDescription
--source-s資料來源：account（完整帳戶）或 key（目前的 API key）。
--format-f輸出格式
--json以 JSON 輸出

​
Account

顯示你的帳戶個人資料。需要 access token。 
cometapi account
cometapi account --json
OptionShortDescription
--format-f輸出格式
--json以 JSON 輸出

​
Stats

顯示目前月份的使用統計。需要 access token。 
cometapi stats
cometapi stats --json
輸出包含：請求次數、使用金額、成功率，以及預估餘額可維持的天數。
OptionShortDescription
--format-f輸出格式
--json以 JSON 輸出

​
Tokens

列出並搜尋您的 API key。需要存取權杖。 
# List API keys (paginated)
cometapi tokens

# Search by keyword
cometapi tokens --search raycast

# JSON output
cometapi tokens --json
OptionShortDescription
--search-s搜尋關鍵字
--page-p頁碼
--page-size每頁結果數
--format-f輸出格式
--json以 JSON 輸出

​
Logs

使用篩選條件瀏覽使用紀錄。需要存取權杖。 
# Recent logs
cometapi logs

# Filter by model
cometapi logs --model gpt-5.4

# Filter by date range
cometapi logs --start 2026-04-01 --end 2026-04-14

# Filter by log type
cometapi logs --type consume

# Export as CSV
cometapi logs --export > usage.csv

# JSON output with limit
cometapi logs --limit 50 --json
OptionShortDescription
--model-m依 model ID 篩選
--token-name依 API key 名稱篩選
--type-t紀錄類型：consume、topup、error、refund、system、manage
--start開始日期（YYYY-MM-DD）
--end結束日期（YYYY-MM-DD）
--group-g依群組篩選
--limit-l最大項目數
--page-p頁碼
--page-size每頁結果數
--export以 CSV 輸出到 stdout
--format-f輸出格式
--json以 JSON 輸出

​
Tasks

顯示 Suno、Midjourney、Luma 和 Kling 等平台的非同步任務紀錄。需要存取權杖。 
# Recent tasks
cometapi tasks

# Filter by platform
cometapi tasks --platform suno

# Filter by status
cometapi tasks --status SUCCESS

# JSON output
cometapi tasks --json
OptionShortDescription
--platform依平台名稱篩選
--status依狀態篩選
--limit-l最大項目數
--format-f輸出格式
--json以 JSON 輸出

​
Doctor

執行診斷以驗證 CLI 設定與 API 連線能力。 
cometapi doctor
cometapi doctor --json
Doctor 會檢查：
  • 設定檔是否存在且可讀
  • API key 是否可用及其來源（config、env 或缺失）
  • 存取權杖是否可用
  • 到 CometAPI 端點的網路連線能力
  • API 驗證是否有效
OptionShortDescription
--format-f輸出格式
--json以 JSON 輸出

​
Config

管理儲存在 ~/.config/cometapi/config.toml 的 CLI 設定。 
# Show current config
cometapi config show

# Set a value
cometapi config set api_key sk-...
cometapi config set default_model claude-sonnet-4-6
cometapi config set output_format json

# Remove a value
cometapi config unset api_key

# Show config file path
cometapi config path
請參閱設定指南以查看所有可用的鍵。

​
Init

執行互動式設定精靈，以設定您的 API key 與存取權杖。 
cometapi init
精靈會將設定寫入 ~/.config/cometapi/config.toml。

​
Repl

啟動完整的互動式命令 shell，讓您無需 cometapi 前綴即可執行任何 CLI 指令。 
cometapi repl

​
Output formats

所有資料指令都支援 --json 或 --format： 
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
FormatDescription
table終端機中的豐富表格（預設）
jsonJSON 輸出
yamlYAML 輸出
csv逗號分隔值
markdownMarkdown 表格
可透過 config 為所有指令設定預設格式： 
cometapi config set output_format json

​
Shell completion

安裝 shell 補全以支援 Tab 自動補全： 
cometapi --install-completion
支援的 shell：Bash、Zsh、Fish。

​
結束代碼

Code含義
0成功
1一般錯誤
2無效的參數
64缺少設定
69服務無法使用
77驗證錯誤