跳轉到主要內容

​
命令總覽

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。需要 access token。 
# 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

使用篩選條件瀏覽使用紀錄。需要 access token。 
# 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 等平台的非同步任務紀錄。需要 access token。 
# 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，或缺失）
  • access token 的可用性
  • 到 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 與 access token。 
cometapi init
精靈會將設定寫入 ~/.config/cometapi/config.toml。

​
Repl

啟動完整的互動式命令 shell，你可以在其中執行任何 CLI 命令，而不需要加上 cometapi 前綴。 
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 表格
你可以透過設定，為所有命令設定預設格式： 
cometapi config set output_format json

​
Shell completion

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

​
Exit codes

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