跳转到主要内容

​
命令概览

CommandDescriptionAuth
chat [MESSAGE]发送消息或启动交互式 REPLAPI 密钥
models列出并搜索可用模型API 密钥
balance显示账户余额API 密钥（或 access token）
account显示账户资料access token
stats显示使用统计信息access token
tokens列出并搜索你的 API 密钥access token
logs使用筛选条件浏览使用日志access token
tasks显示异步任务日志access token
init交互式设置向导—
doctor运行诊断和健康检查API 密钥
config管理 CLI 配置—
repl启动交互式命令 shellAPI 密钥
标记为 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 密钥）。
--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 格式输出

​
Token

列出并搜索你的 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 endpoint 的网络连通性
  • 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 表格
你可以通过 config 为所有命令设置默认格式： 
cometapi config set output_format json

​
Shell completion

安装 shell completion 以支持 Tab 补全： 
cometapi --install-completion
支持的 shell：Bash、Zsh、Fish。

​
退出代码

Code含义
0成功
1一般错误
2无效参数
64缺少配置
69服务不可用
77认证错误