POST /minimax/v1/voice_clone

Method: POSTEndpoint: /minimax/v1/voice_clone

Official Documentation

This section contains endpoint-specific behavior, parameters, or usage notes for this API.

Request Parameters

Header Parameters

Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters application/json

file_id
integer
Required
voice_id
string
Required
clone_prompt
object
Optional
prompt_audio
integer
Required
prompt_text
string
Required
text
string
Optional
model
string
Optional
need_noise_reduction
boolean
Optional
need_volume_normalization
boolean
Optional
aigc_watermark
boolean
Optional
Example
{
"file_id"
:
123456789
,
"voice_id"
:
"<voice_id>"
,
"clone_prompt"
:
{
"prompt_audio"
:
987654321
,
"prompt_text"
:
"This voice sounds natural and pleasant."
}
,
"text"
:
"A gentle breeze sweeps across the soft grass(breath), carrying the fresh scent along with the songs of birds."
,
"model"
:
"speech-2.8-hd"
,
"need_noise_reduction"
:
false
,
"need_volume_normalization"
:
false
,
"aigc_watermark"
:
false
}

Example Request

Shell

curl --location --request POST '/minimax/v1/voice_clone' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "file_id": 123456789,
  "voice_id": "<voice_id>",
  "clone_prompt": {
    "prompt_audio": 987654321,
    "prompt_text": "This voice sounds natural and pleasant."
  },
  "text": "A gentle breeze sweeps across the soft grass(breath), carrying the fresh scent along with the songs of birds.",
  "model": "speech-2.8-hd",
  "need_noise_reduction": false,
  "need_volume_normalization": false,
  "aigc_watermark": false
}'

Response

🟢 200 Success

Content Type: application/json

Response Schema

file
object
Optional
file_id
integer
Unique identifier of the file
Optional
bytes
integer
Optional
File size in bytes
created_at
integer
Optional
Unix timestamp in seconds when the file was created
filename
string
File name
Optional
purpose
string
Purpose of the file.
Optional
base_resp
object
Optional
status_code
integer
Optional
Status codes and their meanings are listed below:
0, request succeeded
1002, rate limit triggered, please try again later
1004, account authentication failed, please check whether the API key is correct
1008, insufficient account balance
1026, the image description contains sensitive content
2013, invalid input parameters, please verify the request body
2049, invalid API key
status_msg
string
Status Details
Optional

Example

{
    "input_sensitive": false,
    "input_sensitive_type": 0,
    "demo_audio": "",
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    }
}