列出音色

POST/v1/get_voice

voice_type 取 voice_cloning 列出你的克隆音色，system 列出系统音色，all 为全部；voice_generation 始终为空。未请求的类别在响应里为 null。

克隆音色只列出你帐户下已克隆成功、尚未删除或过期的音色。系统音色也可以直接看系统音色。

列出音色

curl https://api.hop-base.com/v1/get_voice \
  -H "Authorization: Bearer $HOPBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_type": "voice_cloning"
  }'

200application/json

{
  "system_voice": null,
  "voice_cloning": [
    {
      "voice_id": "MyNarrator01",
      "description": [],
      "created_time": "2026-09-25"
    }
  ],
  "voice_generation": null,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

请求头

Authorization:必填string

Bearer sk-…：控制台「API 密钥」里创建的密钥，所属分组须包含请求的模型

请求体参数JSON

voice_type:必填string

要列出的音色类别

可选值systemvoice_cloningvoice_generationall

200音色列表

system_voice:可选array of object 或 null

系统音色；未请求时为 null

voice_cloning:可选array of object 或 null

你的克隆音色；未请求时为 null

voice_generation:可选array of object 或 null

始终为空数组；未请求时为 null

base_resp:可选object

成功时为 {"status_code": 0, "status_msg": "success"}；错误不走这里，而是非 200 状态码加 error 对象

错误

400voice_type must be one of system, voice_cloning, voice_generation, all，或出现未知字段

401没带密钥、密钥无效或已过期（missing_api_key / invalid_api_key / api_key_expired）

413请求体超过 64 KiB：request body is too large

503音色或文件登记暂不可用，稍后重试（如 voice registry is temporarily unavailable; please retry）

请求头

请求体参数JSON

返回

错误

相关页面