Zum Hauptinhalt springen
POST https://api.novita.ai/v3/minimax-en/v1/t2a_v2 The parameters and usage align with the official documentation. For detailed parameters, refer directly to the official documentation.

1. Overview

This document describes how to use the MiniMax Speech (overseas edition) native protocol: speech recognition, synchronous text-to-speech, asynchronous long-text text-to-speech, file management, voice cloning, and voice design. All requests use the same host https://{api_domain}, where {api_domain} is the API domain provided to you by the platform. Every request must carry the platform API key:
Requests with a JSON body must also set Content-Type: application/json; file-related requests use multipart/form-data.

2. Official references

3. Supported models

4. Speech recognition

The audio file is uploaded as multipart/form-data, and the recognition language is passed in the language header.

5. Synchronous text-to-speech

Set stream to true when you need streaming output. output_format controls whether the audio is returned as a URL or as Base64 data.

6. Asynchronous long-text text-to-speech

Long text is synthesized as a task: create the task first, then poll the query endpoint with the returned task ID.

6.1 Create a task

6.2 Query a task

7. File management

Files are used by voice cloning and by other MiniMax capabilities that accept a file_id. Upload the file first to obtain its file_id.

7.1 Upload a file

purpose declares how the file will be used; use voice_clone for a voice sample.

7.2 Retrieve file information

7.3 Download a file

8. Voice cloning

file_id is the ID returned by the upload endpoint. voice_id is the custom voice ID you assign, and it can be used as voice_setting.voice_id in text-to-speech requests afterwards.

9. Voice design

prompt describes the voice to design, and preview_text is the sample text used to preview the generated voice.
Zuletzt geändert am 17. November 2026