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

# POST /voice-clone/minimax/status

`POST /voice-clone/minimax/status`

## Request

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

Check the status of a MiniMax voice clone job.

## Request body

- VoiceCloneStatusRequest
  - `runId` string, required: Unique identifier for the clone job
  - `cost` number: Cost from the submit ticket (optional)
  - `paymentSource` string: Payment source from the submit ticket (optional)
  - `isApiRequest` boolean: Pass true when polling from API clients (optional)

## Response `200`

Voice clone status

- VoiceCloneMinimaxStatusResponse
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required
  - `audioUrls` string[]: Preview audio URLs (when completed)
  - `metadata` object
  - `error` string: Error message (when failed)

## Other responses

- `400`: Bad Request - Invalid runId
- `401`: Unauthorized - Invalid or missing API key
- `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/status/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)