跳转到主要内容
CometAPI CLI 是一款用于与 CometAPI 平台交互的官方命令行工具。它支持多模型聊天（流式输出和 REPL）、模型搜索、余额与使用量查询、日志浏览以及账户管理——全部都可以在终端中完成。 如果你想在一个页面中获取最新安装命令、包元数据和发布版本，请从 PyPI 包页面 开始。
CometAPI CLI 目前处于测试阶段。在 CLI 接口逐步稳定期间，命令和用户体验可能会有一些小变化。

​
Features

  • 支持流式输出和交互式 REPL 的多模型聊天
  • 模型搜索与列表查看
  • 账户余额和使用统计
  • 支持筛选和 CSV 导出的使用日志浏览
  • 异步任务日志（Suno、Midjourney、Kling 等）
  • 多格式输出：table、JSON、YAML、CSV、Markdown
  • 基于 TOML 的配置与设置向导
  • Bash、Zsh 和 Fish 的 Shell 自动补全
  • 面向 Agent 的设计，提供结构化 JSON 输出和确定性的退出码

​
Prerequisites

​
Installation

将 PyPI 包页面 作为主要安装参考，然后选择以下任一方法安装 CLI： 
pip install cometapi-cli
验证安装： 
cometapi --version

​
Quick start

1

运行设置向导

交互式向导会将你的 API key 和可选的 access token 存储到本地配置文件中：
cometapi init
向导会提示你输入：
2

与模型聊天

发送一条消息并使用流式输出：
cometapi chat "Explain quantum computing in one sentence"
覆盖默认模型：
cometapi chat "Hello!" --model claude-sonnet-4-6
3

搜索可用模型

列出匹配关键字的模型：
cometapi models --search gemini --limit 10
4

检查你的余额

查看你的账户余额：
cometapi balance
显示当前 API key 的计费视图：
cometapi balance --source key
5

运行诊断

验证 CLI 是否能够连接到 CometAPI：
cometapi doctor

​
Interactive chat session

运行不带参数的 cometapi chat 以进入多轮聊天 REPL： 
cometapi chat
REPL 命令：
CommandDescription
/model切换当前使用的模型
/system设置或更改 system prompt
/clear清除对话历史
/history显示对话历史
/save将对话保存到文件
/tokens显示该会话的 token 使用情况
/help列出所有 REPL 命令
/exit退出 REPL

​
Agent integration

该 CLI 专为 AI 编码 Agent 和自动化脚本使用而设计：
  • 所有数据命令都支持 --json，用于结构化、机器可读的输出
  • 确定性的退出码：0（成功）、64（缺少配置）、77（认证错误）、69（服务不可用）
  • 错误输出到 stderr，数据输出到 stdout
  • 每个命令的选项请参见完整的命令参考