声音与克隆
列出声音配置、引擎预设和克隆支持。
GET /v1/audio/voices 将 VoiceStudio 声音库连接到兼容 OpenAI 的客户端。
curl "$VOICESTUDIO_BASE_URL/audio/voices" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY"响应包含两个列表：
voices：OpenAI 别名和您保存的配置。engines：已安装的 TTS 引擎，包含克隆支持、设备路由和设置提示。
只列出您的配置：
curl -s "$VOICESTUDIO_BASE_URL/audio/voices" \
-H "Authorization: Bearer $VOICESTUDIO_API_KEY" \
| jq '.voices[] | select(.type == "profile") | {voice_id, name, language}'将 voice_id 直接传给语音生成：
{
"model": "tts-1",
"voice": "demo0001",
"input": "This line uses a saved VoiceStudio profile."
}voice 接受的值
| 值 | 结果 |
|---|---|
default | 所选引擎的默认声音 |
alloy, echo, fable, nova, onyx, shimmer | 为兼容性而接受；映射到引擎默认值 |
| 配置 ID | 保存的参考音频、转录、风格和种子 |
| 引擎预设 | 传递给提供命名声音的引擎 |
通过 /profiles/* 和 /personas/* 路由创建、锁定、导入、导出配置并管理同意；详见 API 参考。
本地 ID
此处的配置 ID 属于桌面应用。尚未发布的 Cloud 契约使用租户拥有的 Voice 资源；本地配置 ID 或请求体不能原样沿用。