今天，我们将推出 Sonix 命令行界面 — 一款免费、快速的命令行工具，让您轻松掌控整个 Sonix 工作流。上传媒体文件、提取文字稿、运行翻译和摘要任务，以及管理您的账户——所有操作均可通过简短的命令完成，这些命令既可手动执行，也可嵌入脚本，或集成到持续集成（CI）流程中。 这是完整的 Sonix API，被封装在一个名为 声波.

最棒的一点是上手非常简单。只需安装一次，三行命令就能将原始录音处理成存储在磁盘上的成品字幕：

npm install -g @sonix-ai/cli

sonix config set api-key sk_live_xxxxxxxx
sonix media create ./interview.mp3 --language en --wait
sonix transcript get  --format srt > captions.srt

这包括视频上传、转录以及存储在磁盘上的成品 SRT 字幕文件——无需任何胶合代码。.

功能介绍

在幕后，, 声波 处理了所有原本需要你通过原始 API 自行实现的功能：

• 上传任何内容。. 小文件采用快速的一次性上传路径；大文件（我们测试过数GB的文件）则直接且可靠地上传，每个数据块都会独立重试，因此即使网络连接不稳定，也不会导致5 GB的文件上传失败。您无需考虑当前采用的是哪种上传路径—— sonix media create ./big-recording.mov 就是能用。.
• 获取任何格式的成绩单 — 纯文本、SRT、VTT、JSON 或 Avid DS — 直接流式传输到文件或您的终端。.
• 运行您已使用的 AI 功能 — 翻译、字幕烧录、一键生成摘要以及对整个文件夹进行批量摘要生成。.
• 管理您的账户 — 文件夹、团队成员和共享链接，均可通过脚本操作。.
• 等慢的那些。. 添加 --请稍等 该命令会将任务提交给任意进程，CLI 界面会阻塞直至任务完成，然后输出结果。无需再手动编写轮询循环了。.

一切设计都基于管道机制。结果输出到标准输出，诊断信息输出到标准错误，并且 --json 可为您提供任何命令的原始 API 响应——因此 sonix media list --json | jq 和 sonix 转录文件获取 … > 文件 保持整洁。完整的命令和参数参考位于 Sonix CLI 文档.

同样专为人工智能代理而设计

CLI 还有另一类用户群体：诸如 Claude Code 或 Codex 之类的人工智能编码代理。代理无需将庞大的工具模式加载到模型的上下文中，而是可以通过调用 声波 — 一条简单的命令，一个干净的退出代码，搞定。.

sonix agent-context # 通过一次调用将整个命令界面以 JSON 格式返回
sonix setup claude # 安装一个用于 Claude Code 的现成技能 Sonix

如果你更希望你的助理查阅Sonix 像聊天一样 — “找出我对帕特尔博士的采访，并提炼出三大要点”——这就是我们的 MCP 服务器 的用途。命令行界面（CLI）则是这一故事的另一半：当你（或某个代理）希望在管道中使用可信赖的、确定性的、可脚本化的命令时，它便派上用场。.

人们使用它的几种方式

• 一位研究人员指出 sonix media create 位于一个文件夹中 面试 并让脚本在夜间上传并转录整个批次。.
• 播客团队会将生成新的SRT文件作为每个新剧集的构建步骤，无需手动点击。.
• 开发人员无需编写任何 HTTP 代码，即可将 Sonix 集成到现有的媒体管道中。.
• 一个人工智能代理上传一段录音，等待转录文本生成，然后对其进行总结——所有操作均通过shell命令完成。.

开始使用

Sonix CLI 是免费的开源软件（MIT 许可证），可在 Node 20 及以上版本上运行，安装只需几秒钟：

npm install -g @sonix-ai/cli
# 或者，无需安装：
npx @sonix-ai/cli media list

请从以下位置获取您的 API 密钥： my.sonix.ai/api, 运行 sonix config set api-key, ，这样就搞定了。完整的命令和参数参考请参见 我们的 CLI 文档，以及 sonix --help 只需按一下键即可。.

我们很期待看到您会用它来实现哪些自动化功能。一如既往，, 给我们发个消息 如果您有任何反馈、遇到问题，或者想告诉我们您希望接下来看到什么内容。.