跳转到主要内容
POST
/
v1
/
voice_design
Voice Design
curl --request POST \
  --url https://api.minimaxi.com/v1/voice_design \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "prompt": "讲述悬疑故事的播音员,声音低沉富有磁性,语速时快时慢,营造紧张神秘的氛围。",
  "preview_text": "夜深了,古屋里只有他一人。窗外传来若有若无的脚步声,他屏住呼吸,慢慢地,慢慢地,走向那扇吱呀作响的门……"
}'
{
  "trial_audio": "hex 编码音频",
  "voice_id": "ttv-voice-2025060717322425-xxxxxxxx",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Authorizations

Authorization
string
header
required

HTTP: Bearer Auth

  • Security Scheme Type: http
  • HTTP Authorization Scheme: Bearer API_key,用于验证账户信息,可在 账户管理>接口密钥 中查看。

Headers

Content-Type
enum<string>
default:application/json
required

请求体的媒介类型,请设置为 application/json,确保请求数据的格式为 JSON

Available options:
application/json

Body

application/json
prompt
string
required

音色描述。

preview_text
string
required

试听音频文本。 注:试听音频的合成将收取 2 元/万字符的费用

voice_id
string

自定义生成音色的 voice_id。当不传入此参数时,将自动生成并返回一个唯一的 voice_id

aigc_watermark
boolean

是否在合成试听音频的末尾添加音频节奏标识,默认值为 False

Response

200 - application/json
voice_id
string

生成的音色 ID,可用于语音合成

trial_audio
string

使用生成的音色合成的试听音频,以 hex 编码形式返回

base_resp
object

状态码和状态详情

I