POST /minimax/v1/voice_design

Method: POSTEndpoint: /minimax/v1/voice_design

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

prompt
string
Required
preview_text
string
Required
Example
{
"prompt"
:
  // provider-specific example normalized for English documentation
,
"preview_text"
:
  // provider-specific example normalized for English documentation
}

Example Request

Shell

curl --location --request POST '/minimax/v1/voice_design' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "prompt": "Example prompt from provider documentation.",
  // provider-specific example normalized for English documentation
}'

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

{
  // provider-specific example normalized for English documentation
    "voice_id": "ttv-voice-2025060717322425-xxxxxxxx",
    "base_resp": {
        "status_code": 0,
        "status_msg": "success"
    }
}