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.
命令總覽
| Command | Description | Auth |
|---|
chat [MESSAGE] | 傳送單則訊息或啟動互動式 REPL | API key |
models | 列出並搜尋可用模型 | API key |
balance | 顯示帳戶餘額 | API key（或 access token） |
account | 顯示帳戶個人資料 | Access token |
stats | 顯示使用統計 | Access token |
tokens | 列出並搜尋你的 API key | Access token |
logs | 使用篩選條件瀏覽使用紀錄 | Access token |
tasks | 顯示非同步任務紀錄 | Access token |
init | 互動式設定精靈 | — |
doctor | 執行診斷與健康檢查 | API key |
config | 管理 CLI 設定 | — |
repl | 啟動互動式命令 shell | API key |
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
| Option | Short | Description |
|---|
--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
| Option | Short | Description |
|---|
--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
| Option | Short | Description |
|---|
--source | -s | 資料來源：account（完整帳戶）或 key（目前的 API key）。 |
--format | -f | 輸出格式 |
--json | | 以 JSON 輸出 |
Account
顯示你的帳戶個人資料。需要 access token。
cometapi account
cometapi account --json
| Option | Short | Description |
|---|
--format | -f | 輸出格式 |
--json | | 以 JSON 輸出 |
Stats
顯示本月的使用統計。需要 access token。
cometapi stats
cometapi stats --json
| Option | Short | Description |
|---|
--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
| Option | Short | Description |
|---|
--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
| Option | Short | Description |
|---|
--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
顯示 Midjourney、Luma 與 Kling 等平台的非同步任務紀錄。需要 access token。
# Recent tasks
cometapi tasks
# Filter by platform
cometapi tasks --platform kling
# Filter by status
cometapi tasks --status SUCCESS
# JSON output
cometapi tasks --json
| Option | Short | Description |
|---|
--platform | | 依平台名稱篩選 |
--status | | 依狀態篩選 |
--limit | -l | 項目最大數量 |
--format | -f | 輸出格式 |
--json | | 以 JSON 輸出 |
Doctor
執行診斷以驗證 CLI 設定與 API 連線能力。
cometapi doctor
cometapi doctor --json
- 設定檔是否存在且可讀取
- API key 的可用性與來源（config、env，或缺失）
- access token 的可用性
- 到 CometAPI 端點的網路連線能力
- API 驗證是否有效
| Option | Short | Description |
|---|
--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。
精靈會將設定寫入 ~/.config/cometapi/config.toml。
Repl
啟動完整的互動式命令 shell，你可以在其中執行任何 CLI 命令，而不需要加上 cometapi 前綴。
所有資料命令都支援 --json 或 --format：
cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown
| Format | Description |
|---|
table | 終端機中的豐富表格（預設） |
json | JSON 輸出 |
yaml | YAML 輸出 |
csv | 逗號分隔值 |
markdown | Markdown 表格 |
cometapi config set output_format json
Shell completion
安裝 shell completion 以支援 Tab 補全：
cometapi --install-completion
Exit codes
| Code | Meaning |
|---|
0 | 成功 |
1 | 一般錯誤 |
2 | 無效的引數 |
64 | 缺少設定 |
69 | 服務無法使用 |
77 | 驗證錯誤 |
