音色管理

Agent 主路径

通过 Universal Skill 使用 MCP 工具 beatra.voices.list。这是一次不计费的只读调用，返回预置音色与租户自有的克隆音色。

按 category（preset / cloned）、language（BCP-47）、gender 或 query（按名称搜索）筛选。
返回的 voice_id 可直接作为语音合成的 voice 字段；preview_url 让用户在选择前试听。

AI 指南

给 AI 的集成说明

接入自有应用时，可以把这份 API 指南复制给 Claude、Codex 或其他编程助手。

工具参数

{
  "category": "preset",
  "language": "zh-CN"
}

音色条目形如：

{
  "voice_id": "voice_01JX...",
  "display_name": "Sunny female voice",
  "category": "preset",
  "language": "zh-CN",
  "gender": "female",
  "preview_url": "https://cdn.beatra.ai/.../preview.mp3",
  "status": "ready"
}

删除克隆音色

删除仅通过 REST：

curl -X DELETE "$BEATRA_BASE_URL/voices/voice_01JX..." \
  -H "Authorization: Bearer $BEATRA_API_KEY"

返回 204。只能删除自己克隆的音色；预置音色不可删除。

通过 REST 调用

直连协议集成可直接使用音色端点：列表 · 详情 · 删除。推荐通过 Skill + MCP 接入；REST 适合自定义应用直连。