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

​
功能特性

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

​
前置条件

​
安装

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

​
快速开始

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

​
交互式聊天会话

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

​
Agent 集成

该 CLI 旨在供 AI 编码代理和自动化脚本使用：
  • 所有数据命令都支持 --json，以提供结构化、机器可读的输出
  • 确定性的退出码：0（成功）、64（缺少配置）、77（认证错误）、69（服务不可用）
  • 错误输出到 stderr，数据输出到 stdout
  • 各命令的选项请参阅完整的命令参考

​
链接