音色快速复刻 Copy

方法: POST路径: /minimax/v1/voice_design

官方文档

使用本接口，输入文本内容，进行音色设计。

请求参数

Header 参数

Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

prompt
string
必需
preview_text
string
必需
示例
{
"prompt"
:
"讲述悬疑故事的播音员，声音低沉富有磁性，语速时快时慢，营造紧张神秘的氛围。"
,
"preview_text"
:
"夜深了，古屋里只有他一人。窗外传来若有若无的脚步声，他屏住呼吸，慢慢地，慢慢地，走向那扇吱呀作响的门……"
}

请求示例代码

Shell

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

返回响应

🟢 200 成功

内容类型: application/json

响应结构

file
object
可选
file_id
integer
文件的唯一标识符
可选
bytes
integer
可选
文件大小，以字节为单位
created_at
integer
可选
创建文件时的 Unix 时间戳，以秒为单位
filename
string
文件的名称
可选
purpose
string
文件的使用目的
可选
base_resp
object
可选
status_code
integer
可选
状态码及其分别含义如下：
0，请求成功
1002，触发限流，请稍后再试
1004，账号鉴权失败，请检查 API-Key 是否填写正确
1008，账号余额不足
1026，图片描述涉及敏感内容
2013，传入参数异常，请检查入参是否按要求填写
2049，无效的api key
status_msg
string
状态详情
可选

示例

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