---
title: "Voice Design"
method: POST
path: "/v1/voice_design"
tags: ["Voice"]
---

# Voice Design

`POST /v1/voice_design`

## Request

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

Generate voice design based on text prompt

## Request body

- T2VReq
  - `prompt` string, required: Text prompt for voice design
  - `preview_text` string, required: Preview text for voice generation
  - `voice_id` string: Voice ID (optional)
  - `aigc_watermark` boolean: Whether to add AIGC watermark

## Response `200`

Successful response

- T2VResp
  - `trial_audio` string: Trial audio URL
  - `voice_id` string: Generated voice ID

## 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)