API 参考
音色列表
获取所有可用音色(含克隆音色),用于播客、文本转语音等内容生成时选择发言人。
获取音色列表
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://example.com/demo-male.mp3",
"gender": "male",
"language": "zh"
},
{
"name": "晓曼",
"speakerId": "chat-girl-105-cn",
"demoAudioUrl": "https://example.com/demo-female.mp3",
"gender": "female",
"language": "zh"
}
]
}
}