主题模式

MiniMax 音色设计 API 文档 ​

接口简介 ​

使用本接口，通过输入文本描述进行音色设计（文生音色）。系统根据描述生成新音色，并返回试听音频（hex 编码）。生成的 voice_id 可用于后续语音合成。

请求地址与鉴权 ​

项目说明
请求方法POST
请求地址/v1/audio/minimax/voices/design
Content-Typeapplication/json
鉴权方式Authorization: Bearer {api_key}

请求参数 ​

请求体为 application/json。

主请求体 ​

参数名类型必填说明默认值取值范围/格式
promptstring是音色描述文本-描述期望的音色风格、场景等
preview_textstring是试听音频文本，用于合成试听片段-不超过 500 字符；试听按 2 元/万字符 计费
voice_idstring否自定义生成音色的 voice_id；不传则系统自动生成并返回-符合 MiniMax voice_id 规范
aigc_watermarkboolean否是否在试听音频末尾添加音频节奏标识false-

请求示例 ​

cURL ​

bash
curl -X POST "https://aiping.cn/api/v1/audio/minimax/voices/design" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "讲述悬疑故事的播音员，声音低沉富有磁性，语速时快时慢，营造紧张神秘的氛围。",
    "preview_text": "夜深了，古屋里只有他一人。窗外传来若有若无的脚步声，他屏住呼吸，慢慢地，慢慢地，走向那扇吱呀作响的门……",
    "aigc_watermark": false
  }'

带自定义 voice_id ​

json
{
  "prompt": "温暖亲切的女声，适合播报新闻。",
  "preview_text": "各位观众晚上好，欢迎收看今日要闻。",
  "voice_id": "my-news-voice-01",
  "aigc_watermark": false
}

响应格式 ​

成功响应（application/json） ​

json
{
  "voice_id": "ttv-voice-2025060717322425-xxxxxxxx",
  "trial_audio": "<hex 编码的试听音频>",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}
  • voice_id：生成的音色 ID，可用于 语音合成 时指定音色。
  • trial_audio：使用该音色合成的试听音频，hex 编码，可解码后播放。
  • base_resp.status_code：0 表示成功，非 0 见下方错误码。

错误码（base_resp.status_code） ​

状态码说明
0请求结果正常
1000未知错误
1001超时
1002触发 RPM 限流
1004鉴权失败
1008余额不足
1013服务内部错误
1027输出内容错误
1039触发 TPM 限流
2013输入格式信息不正常