MiniMax Voice Design API
MiniMax Voice Design is a next-generation text-to-speech voice creation system that lets developers and creators generate entirely new, custom voices using natural language descriptions instead of reference audio. By defining attributes such as tone, accent, personality, and emotional character through prompts, users can design unique synthetic voices that sound natural and expressive. The system supports multilingual output with native-style accents and is compatible with multiple MiniMax speech models, enabling both high-quality narration and real-time interactive use cases across applications like storytelling, virtual assistants, branded voice experiences, and AI-driven characters.
MiniMax Voice Design API Documentation
MiniMax Voice Design API check status - Request Code
POST https://gateway.pixazo.ai/minimax-voice-design-api-363/v1/minimax-voice-design-api-request-result Content-Type: application/json Cache-Control: no-cache Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY { "request_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8" }import requests url = "https://gateway.pixazo.ai/minimax-voice-design-api-363/v1/minimax-voice-design-api-request-result" headers = { "Content-Type": "application/json", "Cache-Control": "no-cache", "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY" } data = { "request_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8" } response = requests.post(url, json=data, headers=headers) print(response.json())fetch('https://gateway.pixazo.ai/minimax-voice-design-api-363/v1/minimax-voice-design-api-request-result', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Cache-Control': 'no-cache', 'Ocp-Apim-Subscription-Key': 'YOUR_SUBSCRIPTION_KEY' }, body: JSON.stringify({ request_id: 'a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8' }) }) .then(response => response.json()) .then(data => console.log(data)) .catch(error => console.error('Error:', error));curl -X POST "https://gateway.pixazo.ai/minimax-voice-design-api-363/v1/minimax-voice-design-api-request-result" \ -H "Content-Type: application/json" \ -H "Cache-Control: no-cache" \ -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \ --data-raw '{ "request_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8" }'import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.time.Duration; public class ApiRequest { public static void main(String[] args) throws Exception { HttpClient client = HttpClient.newBuilder() .connectTimeout(Duration.ofSeconds(10)) .build(); String json = "{\n \"request_id\": \"a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://gateway.pixazo.ai/minimax-voice-design-api-363/v1/minimax-voice-design-api-request-result")) .header("Content-Type", "application/json") .header("Cache-Control", "no-cache") .header("Ocp-Apim-Subscription-Key", "YOUR_SUBSCRIPTION_KEY") .POST(HttpRequest.BodyPublishers.ofString(json)) .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } } <?php $url = 'https://gateway.pixazo.ai/minimax-voice-design-api-363/v1/minimax-voice-design-api-request-result'; $data = json_encode([ 'request_id' => 'a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8' ]); $ch = curl_init($url); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Content-Type: application/json', 'Cache-Control: no-cache', 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' ]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); echo $response; ?>Output
Successful API response:
{ "status": "COMPLETED", "request_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8", "audio": { "url": "https://storage.pixazo.ai/voices/...", "duration_seconds": 8.7 } }Request Body - MiniMax Voice Design API check status
Parameters for /minimax-voice-design-api-request-result:
| Parameter | Required | Type | Description |
|---|---|---|---|
| request_id | Yes | string | The unique identifier returned from the initial request. Used to poll for completion status and audio URL. |
Example Request - MiniMax Voice Design API check status
JSON
{ "request_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8" }Response - MiniMax Voice Design API check status
JSON
{ "status": "COMPLETED", "request_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8", "audio": { "url": "https://storage.pixazo.ai/voices/a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8.wav", "duration_seconds": 8.7, "sample_rate_hz": 24000, "format": "wav", "voice_profile": "Bubbly and excitable female pop star interviewee, youthful, slightly breathless, and very enthusiastic" } }Request Headers
| Header | Description |
|---|---|
| Content-Type | Must be set to application/json. |
| Cache-Control | Must be set to no-cache. |
| Ocp-Apim-Subscription-Key | Your API subscription key for authentication. |
Response Handling
The MiniMax Voice Design API returns specific HTTP status codes and response bodies to indicate the success or failure of a request. Developers should implement error handling in their applications to manage these responses effectively.
Common Status Codes and Responses
| Status Code | Description | Response Body |
|---|---|---|
| 200 | Success - The request was successfully processed. | { "success": true, ... } |
| 400 | Bad Request - The request contains invalid parameters or missing fields. | { "error": "Invalid request parameters" } |
| 401 | Unauthorized - The provided subscription key is missing or invalid. | { "error": "Invalid or missing authentication" } |
| 403 | Forbidden - The subscription does not have access to this API or action. | { "error": "Access denied for this operation" } |
| 404 | Not Found - The requested resource or endpoint could not be found. | { "error": "Endpoint not found" } |
| 429 | Too Many Requests - The request rate limit has been exceeded. | { "error": "Rate limit exceeded, please retry later" } |
| 500 | Internal Server Error - An unexpected error occurred on the server. | { "error": "An unexpected error occurred, please try again later" } |
Example Error Response
{ "error": "Invalid parameters" }Retrieving Results
After submitting your request, use this endpoint to check status and retrieve results.
Endpoint
POST https://gateway.pixazo.ai/minimax-voice-design-api-363/v1/minimax-voice-design-api-request-result
Request Body
{ "request_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8" }Example Polling Request
curl -X POST "https://gateway.pixazo.ai/minimax-voice-design-api-363/v1/minimax-voice-design-api-request-result" \ -H "Content-Type: application/json" \ -H "Cache-Control: no-cache" \ -H "Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY" \ --data-raw '{ "request_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8" }'Response States
| Status | Description |
|---|---|
| IN_QUEUE | Request is queued and waiting to be processed. Voice synthesis has not yet begun. |
| IN_PROGRESS | Voice generation is actively processing. Audio is being rendered. |
| COMPLETED | Voice generation completed successfully. Audio file URL is available in the response. |
| FAILED | Voice generation failed due to input error, system issue, or timeout. Check the error_message field. |
Example Success Response
{ "status": "COMPLETED", "request_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8", "audio": { "url": "https://storage.pixazo.ai/voices/a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8.wav", "duration_seconds": 8.7, "sample_rate_hz": 24000, "format": "wav", "voice_profile": "Bubbly and excitable female pop star interviewee, youthful, slightly breathless, and very enthusiastic" } }Example In-Progress Response
{ "status": "IN_PROGRESS", "request_id": "a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8", "estimated_completion_time": 12 }