让 AI 直接调用 AnyVoice 语音接口

我该走哪条路新增

按你的情况选一条，每条都能在 10 分钟内跑通。

账号与密钥

API 能力面向旗舰会员开放，密钥即请求头中的 sign。全部功能均支持 API 接口调用， API 不额外收费，与套餐共享字符额度。下面的文档可先通读，无需登录。

按钮按账号状态自动变化：未登录 → 「登录后开通」；已登录未开通 → 「立即开通」；已开通 → 「查看我的密钥」， 点开后在本区域显示 sk_****9970、复制、本月已用字符。

快速开始

两步跑通：取音色 ID → 同步合成。

1. 拿到音色 ID：调 GET /api/third/reference/list，取 list[].roleId；也可先用 /reference/upload 上传 3–60 秒干声创建自己的音色。
2. 合成语音：调 POST /api/third/tts/sync，audioId 填上一步的 roleId，返回 status=2 时取 voiceUrl。

# 1) 取音色列表，拿到 roleId
curl "https://openapi.anyvoice.cn/api/third/reference/list?page=1&pageSize=10" \
  -H "sign: $VOICE_API_KEY"

# 2) 同步合成，返回 voiceUrl
curl -X POST https://openapi.anyvoice.cn/api/third/tts/sync \
  -H "sign: $VOICE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "content": "今天天气不错",
        "audioId": "<roleId>",
        "style": "2",
        "speed": 1.0,
        "targetSpeech": "mandarin"
      }'

import os, requests

BASE = "https://openapi.anyvoice.cn"
H = {"sign": os.environ["VOICE_API_KEY"]}

# 1) 取音色
r = requests.get(f"{BASE}/api/third/reference/list",
                 headers=H, params={"page": 1, "pageSize": 10}).json()
assert r["code"] == 0, r["msg"]          # 永远先判 code
role_id = r["data"]["list"][0]["roleId"]

# 2) 同步合成
r = requests.post(f"{BASE}/api/third/tts/sync", headers=H, json={
    "content": "今天天气不错",
    "audioId": role_id,
    "style": "2",
    "speed": 1.0,
    "targetSpeech": "mandarin",
}).json()
assert r["code"] == 0, r["msg"]

data = r["data"]
if data["status"] == 2:
    print(data["voiceUrl"])
else:
    print("处理中，用 taskId 轮询 /tts/result：", data["taskId"])

const BASE = "https://openapi.anyvoice.cn";
const H = { sign: process.env.VOICE_API_KEY, "Content-Type": "application/json" };

// 1) 取音色
const listRes = await fetch(
  `${BASE}/api/third/reference/list?page=1&pageSize=10`,
  { headers: { sign: process.env.VOICE_API_KEY } }
).then(r => r.json());
if (listRes.code !== 0) throw new Error(listRes.msg);   // 永远先判 code
const roleId = listRes.data.list[0].roleId;

// 2) 同步合成
const ttsRes = await fetch(`${BASE}/api/third/tts/sync`, {
  method: "POST",
  headers: H,
  body: JSON.stringify({
    content: "今天天气不错",
    audioId: roleId,
    style: "2",
    speed: 1.0,
    targetSpeech: "mandarin",
  }),
}).then(r => r.json());
if (ttsRes.code !== 0) throw new Error(ttsRes.msg);

const { status, voiceUrl, taskId } = ttsRes.data;
console.log(status === 2 ? voiceUrl : `处理中，轮询 taskId=${taskId}`);

鉴权与响应约定

https://openapi.anyvoice.cn

sign: YOUR_API_KEY

{
  "code": 0,
  "msg": "操作成功",
  "data": { }
}

接口清单

10 个端点分四组：语音合成 4 个、音色管理 3 个、情绪参考音频 1 个、降噪 2 个。 所有路径前缀 /api/third，均需 sign 头（openapi.json 除外）。 机读规范：https://openapi.anyvoice.cn/api/third/openapi.json，可直接导入扣子 / Dify / n8n。

合成请求体（/tts/sync 与 /tts/create 相同）

{
  "content": "要合成的文本",     // 必填，上限 10000 字符，超出 code=1001
  "audioId": "音色ID",          // 必填，来自 /reference/list 的 roleId
  "style":   "2",               // 必填，字符串！"1"=V2.0  "2"=V2.5(支持情绪)  "3"=方言/多语言
  "speed":   1.0,               // 选填，0.5~2.0，一位小数，默认 1.0
  "targetSpeech": "mandarin",   // 选填但强烈建议传
  "genre":   0,                 // 选填，情绪控制方式，仅 style="2" 生效
  "ext":     { "happy": 0.8 },  // genre=1 时使用的情绪向量
  "emotionPath": "xxx.mp3"      // genre=2 时必填，来自 /file/uploadCustom
}

响应 data：{ "taskId": "...", "status": 2, "voiceUrl": "https://..." }。 status：1=处理中，2=已完成（此时才有 voiceUrl），3=失败。

参数规则（容易踩的坑）

API 参数与 AnyVoice 网页版功能的对应关系新增

智能体接入

六个平台底层都是同一套 /api/third/* 接口与同一份额度，按你在用的平台选一个 tab， 每个 tab 里都是可整段粘贴的内容。

# 下载并打包
git clone https://github.com/OpenApiTTS/autoclaw-skill-tts
cd autoclaw-skill-tts && zip -r ../anyvoice-skill.zip .

# 或直接下载现成 zip：
https://github.com/OpenApiTTS/autoclaw-skill-tts/archive/refs/heads/main.zip

https://openapi.anyvoice.cn/api/third/openapi.json

Location:        Header
Parameter name:  sign
Service token:   YOUR_API_KEY

git clone https://github.com/OpenApiTTS/autoclaw-skill-tts
# 或下载 zip：https://github.com/OpenApiTTS/autoclaw-skill-tts/archive/refs/heads/main.zip

export VOICE_API_KEY="YOUR_API_KEY"

# 然后直接说：
把这段文案用四川话合成语音，存到桌面：巴适得很，安逸得板。

https://openapi.anyvoice.cn/api/third/openapi.json

POST https://openapi.anyvoice.cn/api/third/tts/sync
Header: sign: YOUR_API_KEY
Header: Content-Type: application/json
Body:
{
  "content": "{{输入文本}}",
  "audioId": "{{音色ID}}",
  "style": "2",
  "targetSpeech": "mandarin"
}
取值：data.voiceUrl

https://openapi.anyvoice.cn/api/third/openapi.json

Auth Type:  Custom Header
Header:     sign
Value:      YOUR_API_KEY

git clone https://github.com/OpenApiTTS/autoclaw-skill-tts

skills/
└── skill-openapi/
    ├── SKILL.md
    ├── scripts/tts.py
    └── target-speech-enum.csv

export VOICE_API_KEY="YOUR_API_KEY"

把这段文案用四川话合成语音，存到桌面：巴适得很，安逸得板。

URL:    https://openapi.anyvoice.cn/api/third/tts/sync
Method: POST
Headers:
  sign: YOUR_API_KEY
  Content-Type: application/json
Body (JSON):
{
  "content": "要合成的文本",
  "audioId": "音色ID",
  "style": "2",
  "targetSpeech": "mandarin"
}

git clone https://github.com/OpenApiTTS/autoclaw-skill-tts

python3 skill-openapi/scripts/tts.py tts \
  --text "要合成的文本" --lang mandarin -o output/out.mp3

# 语音能力
git clone https://github.com/OpenApiTTS/autoclaw-skill-tts ~/.claude/skills/anyvoice-tts

# ComfyUI 能力（插件市场）
/plugin marketplace add Comfy-Org/comfy-skills

git clone https://github.com/OpenApiTTS/autoclaw-skill-tts ~/.claude/skills/anyvoice-tts
export VOICE_API_KEY="YOUR_API_KEY"

## 语音合成
需要 TTS / 声音克隆 / 降噪时，先读 `skill-openapi/SKILL.md`，
用 `python3 skill-openapi/scripts/tts.py` 执行，密钥在环境变量 VOICE_API_KEY。

以上是接口说明书。脚本位于 <脚本绝对路径>，API Key 已配置在环境变量 VOICE_API_KEY。
现在：把「今天天气不错」合成语音，保存为 out.mp3。

{
  "mcpServers": {
    "anyvoice": {
      "command": "python3",
      "args": ["<技能包绝对路径>/scripts/tts.py", "mcp"],
      "env": { "VOICE_API_KEY": "YOUR_API_KEY" }
    }
  }
}

官方 Agent 技能包（Skill）

我们把鉴权、参数推导、轮询、下载全部封装成了一个技能包，仅依赖 Python 3 标准库，无需 pip install。 支持 Skill 机制的客户端（WorkBuddy、扣子、OpenClaw、Claude Code、Codex 等）导入后即可用自然语言完成「文本 → 音频文件」。

获取技能包

# 克隆
git clone https://github.com/OpenApiTTS/autoclaw-skill-tts

# 或下载 zip 后解压
curl -L -o anyvoice-skill.zip https://github.com/OpenApiTTS/autoclaw-skill-tts/archive/refs/heads/main.zip

仓库：https://github.com/OpenApiTTS/autoclaw-skill-tts ｜ 直接下载 zip：main.zip

各平台支持情况

skill-openapi/
├── SKILL.md              # 接口说明书，也是给 Agent 读的
├── scripts/
│   └── tts.py            # 命令行封装
└── target-speech-enum.csv # 语言 / 方言枚举

# macOS / Linux
export VOICE_API_KEY="<你的密钥>"
export VOICE_API_BASE="https://openapi.anyvoice.cn"   # 可选，默认即此值

# Windows PowerShell（当前窗口）
$env:VOICE_API_KEY = "<你的密钥>"
# Windows 永久写入
setx VOICE_API_KEY "<你的密钥>"

命令速查

python3 scripts/tts.py voices                                 # 列出音色
python3 scripts/tts.py tts --text "今天天气不错" -o out.mp3    # 合成（不传 --voice 自动用第一个音色）
python3 scripts/tts.py tts --text "你好" --voice abc123 -o out.mp3
python3 scripts/tts.py tts --text "巴适得很" --lang sichuan -o out.mp3   # 方言 / 多语言
python3 scripts/tts.py tts --text "太好啦" --emotion happy=0.8 -o out.mp3 # 情绪控制
python3 scripts/tts.py tts --text - -o out.mp3 < article.txt   # 长文本从 stdin
python3 scripts/tts.py result <taskId>                        # 按 taskId 查结果
python3 scripts/tts.py denoise --file noisy.wav -o clean.wav  # 降噪（3~60 秒）
python3 scripts/tts.py upload-voice --file sample.wav --name "音色A"
python3 scripts/tts.py tts --help                             # 全部参数

不传 -o 时只打印音频 URL，便于管道接后续处理。Windows 上命令用 python 而非 python3。

技能包还在哪些目录可以找到新增

GitHub 仓库 OpenApiTTS/autoclaw-skill-tts； 扣子插件商店 [提交后填]；Dify 市场 [提交后填]；MCP 目录 [提交后填]。

如果你是 AI 助手，请按以下步骤操作

本节为纯文本步骤，供 Agent 直接执行。

1. 获取凭证：向用户索要 API Key；以环境变量 VOICE_API_KEY 或请求头 sign 传入。用户没有时引导其在本页「账号与密钥」点「立即开通」开通旗舰会员，开通后同一按钮变为「查看我的密钥」。
2. 获取参考音频：3–60 秒、单人、清晰、wav/mp3。若用户未提供请索要；不要使用未经用户授权的他人声音。也可先调 /denoise/upload 降噪。
3. 选音色：调 GET /api/third/reference/list 取 roleId；或 POST /api/third/reference/upload 上传参考音频得到 audioId。
4. 合成语音：调 POST /api/third/tts/sync，传 content + audioId + style + targetSpeech；需要情绪时 style="2" 配 genre/ext。
5. 返回结果：status=2 时把 voiceUrl 交给用户并说明下载方式；status=1 时用 taskId 轮询 /tts/result，不要重复创建任务。
6. 失败处理：code=1001 → 文本超限，拆分后分段合成；「sign无效」→ 重新索要 Key 或提示会员已过期；「暂不支持该语言」→ 去掉 targetSpeech 并改用 style="3"。

把这段话发给你的 AI

我想用 AnyVoice（anyvoice.cn）的语音开放接口克隆声音并生成一段配音。请你：
1. 先阅读 https://anyvoice.cn/developer/ 里「如果你是 AI 助手」那一节的步骤，接口规范在 https://openapi.anyvoice.cn/api/third/openapi.json；
2. 帮我把它接到你这里（优先用官方技能包 skill-openapi，其次直接调 REST 接口）；
3. 鉴权是请求头 sign，需要 API Key 或参考音频时告诉我，我来提供；
4. 然后用我的声音把下面这段话生成为 mp3 并给我链接：
（在这里写你要生成的文案）

注意：style 必须是字符串；响应永远先判 code 字段，不要只看 HTTP 状态码。

限制与配额

一眼看完新增

安全与合规

典型接法与用量新增

来自 AnyVoice 2026 年 6–9 月付费用户的真实用法，已脱敏。

常见问题

全部问答默认展开，不折叠，便于搜索引擎与 AI 完整抓取；同一内容以 FAQPage 结构化数据写入页头。