Ori联系我们

文档OriHub

查询音色列表

查平台预设音色和自己克隆的音色。

TTS 的 voice_id 从这里拿。

请求

curl "https://api.lk888.ai/v1/skills/voices" \
  -H "Authorization: Bearer $OPENAI_API_KEY"

响应

{
  "total": 3,
  "voices": [
    {
      "voice_id": "Zephyr",
      "name": "雯雯",
      "type": "preset",
      "model": "gem-2.5-tts",
      "gender": "女",
      "description": "明亮",
      "demo_audio": "https://cos.example.com/uploads/demo.wav"
    },
    {
      "voice_id": "male-qn-qingse",
      "name": "青涩青年音色",
      "type": "preset",
      "model": "vidu-jieshuoman",
      "language": "中文 (普通话)",
      "demo_audio": "https://scene.example.com/media-asset/072356.mp3"
    },
    {
      "voice_id": "LK_1_1772275968",
      "name": "爆米",
      "type": "cloned",
      "model": "speech-2.8",
      "is_permanent": true,
      "days_left": 0,
      "created_at": "2026-02-28T18:53:03+08:00",
      "demo_audio": "https://cos.example.com/uploads/demo.mp3"
    }
  ]
}

字段

字段 说明
voice_id 放进请求体的 params.voice_id
name 音色名
type preset 平台预设 / cloned 自己克隆的
model 归属模型
applicable_models 这个音色能用哪些模型(GEM 音色靠这个字段区分)
demo_audio 试听地址
gender / description / language 有的音色才有
is_permanent 克隆音色是否已转永久
days_left 克隆音色还剩几天有效
created_at 克隆时间

按模型筛

?model= 可以筛,传哪个模型名就返回哪一批:

?model= 拿到什么
speech-2.8 你克隆的音色
gem-2.5-tts / gem-3.1-tts GEM 预设音色,两系共用同一批
doubao-tts-2.0 豆包预设音色
vidu-jieshuoman Vidu 解说漫预设音色,带 language
不传 全部

特别注意

  • GEM 全量列表里 model 字段固定回显 gem-2.5-tts,不代表 3.1 没有音色 —— 以每条的 applicable_models 为准
  • 过期的克隆音色不在列表里 —— 克隆出来的音色 7 天有效期内要用过一次才转永久
  • doubao-tts-2.0 不传 voice_id 时走默认音色 zh_female_vv_uranus_bigtts
  • 新账号没克隆过音色时,?model=speech-2.8 返回空列表属正常