音色查询

接口说明

请求示例

curl "https://unifiedtts.com/api/v1/voices?model=edge-tts-v2"

model

必填查询参数；模型查询返回的已启用模型 ID，例如 edge-tts-v2 或 azure-tts。

响应说明

{
  "data": [
    {
      "id": "zh-CN-XiaoxiaoNeural",
      "modelId": "edge-tts-v2",
      "name": "晓晓",
      "locale": "zh-CN",
      "language": "中文",
      "previewUrl": "https://media.fastgoing.org/unifiedtts/samples/素材目录/音色ID.版本.mp3"
    }
  ],
  "catalog": "static"
}

示例仅展示相关字段，目录内容、价格及结果以实际响应为准。

使用说明

使用 modelId 与 id 共同选择音色；合成请求中的 model 对应 modelId，voice 对应 id。同名音色可同时存在于多个模型，不能只按音色 ID 定位。

先通过模型查询选择已启用模型，再传入一个 model 查询参数。缺失、空值或重复参数返回 400 INVALID_REQUEST；未知模型返回 400 MODEL_NOT_SUPPORTED；停用模型返回 503 MODEL_DISABLED，不回退到其他模型。

返回该模型的完整可用音色，语言和性别由客户端筛选。styles、roles 等能力按具体音色声明，不能套用其他音色的设置。

previewUrl 非空时是公开媒体的绝对 HTTPS 地址，可直接播放；为空表示尚无试听，不要请求空地址。无需鉴权且不占用额度，请勿向媒体域名发送 API Key 或登录凭证。素材目录与模型 ID 独立，请不要拼接地址或修改扩展名，部分试听为 WAV 原件。官方示例未提供原文时 preview.text 为空，不展示文案详情；试听仅供选声，合成结果取决于所选模型。