MiniMax 音色设计

输入文本内容进行音色设计，生成自定义音色。

POST /v1/voice_design

请求头

参数名	类型	必填	默认值	说明
Content-Type	string	是	application/json	数据交换格式
Authorization	string	是	-	鉴权信息，格式为 Bearer <API_KEY>

请求体

参数名	类型	必填	说明
prompt	string	是	音色描述文本
preview_text	string	是	试听音频文本，最长 500 字符。合成费用 2元/万字符
voice_id	string	否	自定义生成的音色 ID，不传时系统自动生成唯一 ID
aigc_watermark	boolean	否	是否在试听音频末尾添加音频水印节奏标识，默认 false

请求示例

curl --request POST \
  --url https://neolink.com/minimax/v1/voice_design \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "讲述悬疑故事的播音员，声音低沉富有磁性，语速时快时慢，营造紧张神秘的氛围。",
    "preview_text": "夜深了，古屋里只有他一人。窗外传来若有若无的脚步声，他屏住呼吸，慢慢地，慢慢地，走向那扇吱呀作响的门……"
  }'

成功响应（HTTP 200）

{
  "voice_id": "ttv-voice-2025060717322425-xxxxxxxx",
  "trial_audio": "hex 编码音频",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

字段	类型	说明
voice_id	string	生成的音色 ID，用于后续语音合成
trial_audio	string	试听音频，hex 编码格式
base_resp.status_code	int	状态码；具体定义见错误码
base_resp.status_msg	string	状态详情