---
title: "Get Voice"
method: POST
path: "/v1/get_voice"
tags: ["Voice"]
---

# Get Voice

`POST /v1/get_voice`

## Request

- Base URL: `https://api.minimax.io`
- URL: `https://api.minimax.io/v1/get_voice`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/minimax/apis/minimax-api-2/docs/v1/get_voice/post.ts> (a function with typed inputs; its response is checked against the schema)

Get available voices by type

## Request body

- GetVoiceReq
  - `voice_type` 'system_voice' | 'voice_cloning' | 'voice_generation' | 'music_generation' | 'voice_slots', required: Type of voice to retrieve

## Response `200`

Successful response

- GetVoiceResp
  - `system_voice` VoiceInfo[]: System voices
    - `voice_id` string: Voice ID
    - `name` string: Voice name
    - `description` string: Voice description
    - `gender` string: Voice gender
    - `language` string: Voice language
    - `age` string: Voice age
    - `style` string: Voice style
    - `created_at` integer: Creation timestamp
    - `updated_at` integer: Last update timestamp
  - `voice_cloning` VoiceInfo[]: Voice cloning voices
    - `voice_id` string: Voice ID
    - `name` string: Voice name
    - `description` string: Voice description
    - `gender` string: Voice gender
    - `language` string: Voice language
    - `age` string: Voice age
    - `style` string: Voice style
    - `created_at` integer: Creation timestamp
    - `updated_at` integer: Last update timestamp
  - `voice_generation` VoiceInfo[]: Voice generation voices
    - `voice_id` string: Voice ID
    - `name` string: Voice name
    - `description` string: Voice description
    - `gender` string: Voice gender
    - `language` string: Voice language
    - `age` string: Voice age
    - `style` string: Voice style
    - `created_at` integer: Creation timestamp
    - `updated_at` integer: Last update timestamp
  - `music_generation` VoiceInfo[]: Music generation voices
    - `voice_id` string: Voice ID
    - `name` string: Voice name
    - `description` string: Voice description
    - `gender` string: Voice gender
    - `language` string: Voice language
    - `age` string: Voice age
    - `style` string: Voice style
    - `created_at` integer: Creation timestamp
    - `updated_at` integer: Last update timestamp
  - `voice_slots` VoiceInfo[]: Voice slots
    - `voice_id` string: Voice ID
    - `name` string: Voice name
    - `description` string: Voice description
    - `gender` string: Voice gender
    - `language` string: Voice language
    - `age` string: Voice age
    - `style` string: Voice style
    - `created_at` integer: Creation timestamp
    - `updated_at` integer: Last update timestamp

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/minimax/apis/minimax-api-2.md) - [All operations](https://skmtc.dev/minimax/apis/minimax-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/minimax/apis/minimax-api-2/revisions/b18c2ab45c0e?raw)