---
title: "POST /voice-clone/minimax"
method: POST
path: "/voice-clone/minimax"
---

# POST /voice-clone/minimax

`POST /voice-clone/minimax`

## Request

- Base URL: `https://api.nano-gpt.com/api`
- URL: `https://api.nano-gpt.com/api/voice-clone/minimax`
- Auth: API key in header `x-api-key`

Submit a MiniMax voice cloning job. Returns 202 with a runId. Use the status endpoint to poll until completion.

## Request body

- VoiceCloneMinimaxJsonRequest
  - `audioUrl` string: URL to a hosted audio file
  - `customVoiceId` string, required: Unique identifier for the cloned voice (MiniMax). Must match ^[A-Za-z][A-Za-z0-9]{7,}$
  - `voiceCloneModel` string: Voice clone model variant (provider-specific)
  - `needNoiseReduction` boolean: Apply noise reduction to the reference audio
  - `needVolumeNormalization` boolean: Normalize reference audio volume
  - `accuracy` number: Text validation accuracy threshold (0-1)
  - `text` string: Preview text to generate a sample audio clip

## Response `202`

Voice clone job started

- VoiceCloneAsyncResponse
  - `status` 'pending', required: Current status
  - `runId` string, required: Unique identifier for the clone job
  - `model` string: Voice clone model identifier
  - `cost` number: Cost of the clone run
  - `paymentSource` string: Payment source used (USD or XNO)
  - `isApiRequest` boolean: Whether this is an API request
  - `fileName` string: Original file name
  - `fileSize` integer: File size in bytes

## Other responses

- `400`: Bad Request - Invalid parameters or audio format
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient balance
- `413`: Payload Too Large - Audio exceeds size limit
- `500`: Internal Server Error

## Changes

- **2026-11-03** `cc8b07d75689`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nano-gpt/apis/nanogpt-api/changes/voice-clone/minimax/post.md)

---

[API](https://skmtc.dev/nano-gpt/apis/nanogpt-api.md) - [All operations](https://skmtc.dev/nano-gpt/apis/nanogpt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nano-gpt/apis/nanogpt-api/revisions/cc8b07d75689?raw)