音色设计

POST

/minimax/v1/voice_design

根据文本描述生成自定义音色，返回可用于语音合成的 voice_id。

网站中的模型与调用示例

音色设计

请求示例 · 示例 1

{
  "aigc_watermark": false,
  "preview_text": "夜深了，古屋里只有他一人。窗外传来若有若无的脚步声，他屏住呼吸，慢慢地，慢慢地，走向那扇吱呀作响的门……",
  "prompt": "讲述悬疑故事的播音员，声音低沉富有磁性。",
  "voice_id": "yssj00043333"
}

请求参数

Header 参数

Body 参数application/json必填

示例

音色设计音色设计 · 示例 1

{
    "prompt": "讲述悬疑故事的播音员，声音低沉富有磁性。",
    "preview_text": "夜深了，古屋里只有他一人。窗外传来若有若无的脚步声，他屏住呼吸，慢慢地，慢慢地，走向那扇吱呀作响的门……",
    "voice_id": "yssj00043333",
    "aigc_watermark": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

音色设计音色设计 · 示例 1

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

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "message": "success",
    "data": {
        "task_id": "task_example_001"
    }
}

🟠400请求有误

修改于 2026-10-24 18:33:12

检索(用于视频下载,异步音频下载)

音色快速复刻

音色设计

网站中的模型与调用示例#

音色设计#

请求示例 · 示例 1#

请求参数

请求示例代码

返回响应

网站中的模型与调用示例

音色设计

请求示例 · 示例 1