快速开始

1. 安装

需要 Node.js 22 或更高版本。以下单行命令适用于 PowerShell 和 Bash。

npm install -g @kittaai/cli
kitta --version

2. 连接账号

在 API 设置创建 API Key。运行以下命令，在隐藏输入提示中粘贴密钥，不要将密钥放入命令参数或截图。

kitta auth login
kitta auth status --json

这是 API Key 认证，不是浏览器 OAuth 登录。

3. 选择声音

kitta audio models list --json
kitta audio voices list --all --language zh --json

从返回结果复制一个可用的声音 ID，替换下一步的 VOICE_ID。付费生成需要足够的 API 额度。

4. 生成并保存

kitta audio tts --voice VOICE_ID --text "Hello from Kitta" --output hello.mp3

--output 会隐含等待任务完成。成功后，当前目录中出现 hello.mp3，退出码为 0。已有文件不会被覆盖。

如果没有拿到文件

保留错误中的任务 ID。超时或 Ctrl+C 只停止本地等待，不会取消或退款。不要立即重复生成；先阅读 任务恢复.

下一步：阅读 安装与认证.