跳转到主要内容

​
命令概览

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启用或禁用流式输出（默认：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 的可用性及其来源（配置、环境变量，或缺失）
  • 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

​
输出格式

所有数据命令都支持 --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 自动补全以支持 Tab 补全： 
cometapi --install-completion
支持的 shell：Bash、Zsh、Fish。

​
Exit codes

CodeMeaning
0成功
1一般错误
2无效参数
64缺少配置
69服务不可用
77身份验证错误