Vox

接入文档

REST API 直调 · MCP · Skill 一键安装

安装 Vox Skill

一行 curl 命令把 Vox 装到你的 AI agent 里——以后你跟它说「合成语音 / 配音 / 中文 TTS」时 它会自动调 Vox 的接口生成 mp3。零依赖，不需要 git / npm / MCP 配置。

第 1 步：拿到 API key

没有 key？去 https://vox.timor419.com/get-key 跟着流程走。拿到以 JK 开头的 key 后，把它放进环境变量：

shell rc 文件（~/.zshrc / ~/.bashrc）
export VOX_API_KEY=JK********

提醒：永远不要把 API key 粘贴到 AI 聊天里——它会留在对话历史中。

第 2 步：选你的 agent，跑一行命令

Claude Code
mkdir -p ~/.claude/skills/vox && curl -fsSL https://vox.timor419.com/skill.md -o ~/.claude/skills/vox/SKILL.md
用户级；下次新开对话即识别。
小龙虾 / OpenClaw
mkdir -p ~/.openclaw/skills/vox && curl -fsSL https://vox.timor419.com/skill.md -o ~/.openclaw/skills/vox/SKILL.md
如已有自定义 skills 目录，按官方 docs 的路径放即可。
爱马仕 / Hermes Agent
mkdir -p ~/.hermes/skills/vox && curl -fsSL https://vox.timor419.com/skill.md -o ~/.hermes/skills/vox/SKILL.md
Cursor
mkdir -p .cursor/commands && curl -fsSL https://vox.timor419.com/skill.md -o .cursor/commands/vox.md
项目级，团队场景可入仓共享。
字节 Trae
mkdir -p ~/.trae/skills/vox && curl -fsSL https://vox.timor419.com/skill.md -o ~/.trae/skills/vox/SKILL.md
阿里通义灵码
mkdir -p ~/.lingma/skills/vox && curl -fsSL https://vox.timor419.com/skill.md -o ~/.lingma/skills/vox/SKILL.md
项目级放 .lingma/skills/vox/。
Cline
mkdir -p .clinerules && curl -fsSL https://vox.timor419.com/skill.md -o .clinerules/vox.md
走 Rules 装载。

没在表里的 agent？只要它支持 Agent Skills 开放标准，把 https://vox.timor419.com/skill.md 丢进它的 skills 目录即可。

第 3 步：试一下

重启 agent（如果它需要的话），然后跟它说：

帮我用中文配音「你好，世界」

agent 会列几个推荐音色让你选，调 Vox API，把合成好的 mp3 公网 URL 直接给你——浏览器打开链接即可播放。

FAQ

必须用 curl 吗？能用 MCP 吗？

可以。Vox 同时提供 HTTP MCP server（3 个 tool：tts / voices / balance）。如果你的 agent 已支持 MCP 且想要结构化调用体验， 就在 agent 的 MCP 配置里加：

json
{
  "mcpServers": {
    "vox": {
      "url": "https://vox.timor419.com/mcp",
      "headers": { "Authorization": "Bearer JK********" }
    }
  }
}

但 Skill 默认推荐 curl 路径——所有 agent 通用，不要求 agent 端支持 MCP。

合成结果怎么播放？

Skill 拿到的是一个永久公网 mp3 URL（在 Vox 自己的 CDN 上）。Agent 会把链接直接给你， 浏览器点开即播。需要本地保存？让 agent 跑 curl -o 下载即可，不需要 ffmpeg / mpv 等本地播放器。

长文本（> 2000 字）怎么办？

Skill 会按句号断句拆段调用，给你多个 URL 各自一段。需要拼成一个文件可选 ffmpeg 合并。

Skill 内容会更新吗？怎么拿最新版？

有更新时重跑上面的 curl 命令覆盖即可（命令带 -o 是覆盖写入）。 内容版本号在 skill.md 顶部 frontmatter 可见。

相关链接