Minimax Voice Clone API: AI Audio Generation

Minimax Voice Clone API Reference

Endpoint

POST https://api.muapi.ai/api/v1/minimax-voice-clone

Submit a job with your MuApi API key in the x-api-key header, then poll https://api.muapi.ai/api/v1/predictions/{request_id}/result until status is completed.

Parameters

Name	Type	Required	Description
audio_url	string	Yes	Url of the audio url.
custom_voice_id	string	Yes	Custom user-defined ID. Minimum 8 characters must include letters and numbers and start with a letter. Duplicate voice-ids will throw an error.
model	string	No	Specify the TTS model to be used for the preview. This is only a preview after cloning. Once the model is generated, any Minimax Turbo or HD voice model can be used for inference.Options: speech-02-hd, speech-02-turbo, speech-2.5-hd-preview, speech-2.5-turbo-preview, speech-2.6-hd, speech-2.6-turboDefault: "speech-02-hd"
need_noise_reduction	boolean	No	Enable noise reduction. Default is false (no noise reduction).Default: false
need_volume_normalization	boolean	No	Specify whether to enable volume normalization.Default: false
accuracy	int	No	Text validation accuracy threshold, with a value range of [0, 1].Default: 0.7
prompt	string	No	Text for audio preview. Limited to 2000 characters.

cURL example

REQUEST_ID=$(curl -s -X POST https://api.muapi.ai/api/v1/minimax-voice-clone \
  -H "x-api-key: $MUAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio_url":"https://example.com/your-audio_url","custom_voice_id":"<custom_voice_id>"}' | jq -r .request_id)

curl -s https://api.muapi.ai/api/v1/predictions/$REQUEST_ID/result -H "x-api-key: $MUAPI_API_KEY"

Python example

import os, time, requests

API = "https://api.muapi.ai/api/v1"
headers = {"x-api-key": os.environ["MUAPI_API_KEY"]}

r = requests.post(f"{API}/minimax-voice-clone", headers=headers, json={"audio_url":"https://example.com/your-audio_url","custom_voice_id":"<custom_voice_id>"})
request_id = r.json()["request_id"]

while True:
    res = requests.get(f"{API}/predictions/{request_id}/result", headers=headers).json()
    if res["status"] == "completed":
        print(res["outputs"]); break
    if res["status"] == "failed":
        raise RuntimeError(res.get("error"))
    time.sleep(3)

Full docs and agent/MCP integration: llms.txt. Get an API key at muapi.ai/access-keys.