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 | | 启用或禁用流式输出（默认：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 的可用性及其来源（配置、环境变量，或缺失）
- 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 自动补全以支持 Tab 补全：
cometapi --install-completion
Exit codes
| Code | Meaning |
|---|
0 | 成功 |
1 | 一般错误 |
2 | 无效参数 |
64 | 缺少配置 |
69 | 服务不可用 |
77 | 身份验证错误 |
