音色列表

获取所有可用音色（含克隆音色），用于播客、文本转语音等内容生成时选择发言人。

获取音色列表

GET /v1/speakers/list

获取所有可用的音色（包含克隆音色），用于后续创建内容时选择音色。

请求示例：

# 获取所有中文音色
curl -X GET "https://api.marswave.ai/openapi/v1/speakers/list?language=zh" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY"

# 获取所有英文音色
curl -X GET "https://api.marswave.ai/openapi/v1/speakers/list?language=en" \
  -H "Authorization: Bearer $LISTENHUB_API_KEY"

const response = await fetch('https://api.marswave.ai/openapi/v1/speakers/list?language=zh', {
  headers: {
    'Authorization': `Bearer ${process.env.LISTENHUB_API_KEY}`,
  },
});
const data = await response.json();
console.log(data);

import os
import requests

response = requests.get(
    'https://api.marswave.ai/openapi/v1/speakers/list',
    headers={'Authorization': f'Bearer {os.environ["LISTENHUB_API_KEY"]}'},
    params={'language': 'zh'}
)
data = response.json()
print(data)

响应示例：

{
  "code": 0,
  "message": "",
  "data": {
    "items": [
      {
        "name": "原野",
        "speakerId": "CN-Man-Beijing-V2",
        "demoAudioUrl": "https://assets.listenhub.ai/listenhub-public-prod/audios/CN-Man-Beijing-V2_pending_1761140378252.mp3",
        "gender": "male",
        "language": "zh",
        "profile": {
          "pitch": ["medium-low"],
          "speed": ["medium"],
          "traits": ["steady", "magnetic", "warm", "clear"],
          "styles": ["steady", "narrative", "compelling"],
          "scenes": ["documentary", "audiobook", "promotional-video"],
          "accent": "Standard Mandarin",
          "description": "A steady, magnetic voice at a moderate pace, suitable for various narrative content.",
          "descriptionLocalized": {
            "zh": "嗓音沉稳磁性，语速适中，适合各类叙事性内容。",
            "en": "A steady, magnetic voice at a moderate pace, suitable for various narrative content."
          }
        }
      }
    ]
  }
}

响应字段说明：

字段	类型	说明
`name`	string	音色显示名称
`speakerId`	string	音色唯一标识符，创建内容时使用
`demoAudioUrl`	string	音色 demo 音频 URL
`gender`	string	`"male"` 或 `"female"`
`language`	string	语言代码，如 `"zh"`、`"en"`
`profile`	object	音色体验描述信息
`profile.pitch`	string[]	音高范围，如 `["medium-low"]`
`profile.speed`	string[]	语速，如 `["medium"]`
`profile.traits`	string[]	音色特征，如 `["steady", "magnetic"]`
`profile.styles`	string[]	情感风格，如 `["steady", "narrative"]`
`profile.scenes`	string[]	推荐使用场景，如 `["documentary", "audiobook"]`
`profile.accent`	string	口音描述，如 `"Standard Mandarin"`
`profile.description`	string	音色综合描述（英文）
`profile.descriptionLocalized`	object	按语言代码索引的本地化描述

音色试听

API 响应中的 demoAudioUrl 字段提供了每个音色的 demo 音频链接。你可以用它让用户在选择音色前先试听，提升选择体验。

所有可用中文音色：

音色名称	音色 ID	性别	描述
晚吟	`wanjin-971d09f0`	女	该女声清晰柔和，语速适中，情感平静而坚定，适合旁白或表达内心独白的内容。
晓曼	`chat-girl-105-cn`	女	一位清晰温和、专业亲切的女声，适合播客、职场培训和知识分享等内容。
苏哲	`suzhe-45bbbe54`	男	声音清晰明亮，语速中快，适合科普讲解、纪录片旁白等知识性内容。
高晴	`gaoqing3-bfb5c88a`	女	一位声音清晰明亮、语速适中偏快的女性播音员，充满活力和亲和力，适合各类专业讲解和播客内容。
原野	`CN-Man-Beijing-V2`	男	嗓音沉稳磁性，语速适中，适合各类叙事性内容。
国栋	`liyan2-ef9401ec`	男	一位声音沉稳洪亮、吐字清晰的男性，适合进行专业、严肃的知识分享和内容解说。
子墨	`liyan3-f74976d9`	男	一位男士声音，音色清晰温和，语速适中，情感平静沉稳，适合叙述和讲故事。
直播雪姐	`zhibonusheng-7b0dbae2`	女	声音明亮清晰，语速快且富有活力，适合直播带货、广告宣传等需要高感染力的场景。
常四爷	`shuoshurennan-fdfa85f9`	男	一位成熟、磁性的男声，语速沉稳，语调富有叙述感和沉思，适合历史纪录片、有声书等内容。
古今先生	`pingshu-c7c18f5a`	男	一位声线浑厚、语速中快的男性配音，充满磁性与沉稳，适合历史叙事、传统评书及有声书旁白。
冥想阿星	`midnightaxing-0bf9d7a5`	男	一位声线沉稳、温柔磁性的男声，语速缓慢，充满治愈感，适合冥想和睡前陪伴。
冥想阿岚	`midnightalan-cb312cb6`	女	声音柔和温暖，语速缓慢，充满治愈感，适合冥想助眠。
直播浩哥	`zhibonansheng-80bf8621`	男	一位男士以快速、清晰且充满活力的声音进行直播带货，语调热情，具有很强的说服力。
故事云舒	`huibennulaoshi-bf2bbe1f`	女	一位声音亲切、明亮的女性，以温柔活泼的语调讲述儿童故事，富有感染力。
故事精灵	`gushijingling-720c0ae5`	男	一个活泼俏皮的童声，语速中快，适合儿童故事、动画片和游戏配音。
约翰大叔	`dp-6cc9831f`	男	一位音色清晰、温和且专业的男声，适合播客、讲解和广播等场景。
山姆大叔	`sam-34cf3074`	男	清晰友好，自信稳重的男声，适合各类沟通交流场景。
笑笑	`voice-clone-69412c2e05707c916796efd1`	女	一位音色清晰明亮、语速适中的女性，适合进行亲切的讲述和知识分享。
猴哥	`houge-ce107859`	男	充满活力、顽皮自信的男性声音，适合动画片或儿童剧中的英雄角色，如孙悟空。
八戒	`bajie-4f6ab1a8`	男	富有憨厚讨好感的男声，适合动画片和儿童故事中的角色。
若云	`xiaoyun`	女	该女声清澈明亮，语速较快，音色甜美柔和，富有叙述感和诗意，适合有声书、诗歌朗诵及文化节目。
诗涵	`xinyi6`	女	该声音清晰温柔，音色醇厚舒缓，语速适中偏慢，适合有声读物、冥想引导及文化节目旁白，带来宁静优雅的听觉体验。
振松	`nanzhongyin-4897116a`	男	该声音沉稳专业，语速适中，发音清晰，富有磁性，适合商业播客、新闻广播及知识分享等场景。
暮歌	`nvdiyin-7b293152`	女	一位女性的嗓音，音色清晰温暖，语速适中，情感平静沉稳，适合用于叙述和旁白场景。
柳飞霜	`shuoshurennan-b09f844f`	女	该声音沉稳洪亮，富有磁性与叙事感，语速适中，适合历史讲解、有声书及纪录片旁白。
宛星 (ASMR)	`ASMR-Female-CN`	女	温柔舒缓的ASMR女声，语速缓慢，音色轻柔，适合助眠、放松和冥想，带来宁静的听觉体验。
远舟 (ASMR)	`ASMR-Male-CN`	男	男声，音色柔和磁性，语速缓慢，非常适合作为ASMR内容，帮助听众放松入眠。
小花妖	`1luoxiaohei1vocals-88bfc421`	女	这是一位音色清澈甜美、语速中快、充满活力的少女音，适合动画、儿童节目及休闲Vlog。
哈基米	`hajimi-427f918d`	女	声音高亢稚嫩，带着哭腔和委屈感，语速中快，充满撒娇和抱怨的情绪，适合动画角色或表达柔弱不满。

获取音色列表

音色试听

On this page