# MiniMax Voice Design API

> MiniMax Voice Design by MiniMax creates a new reusable voice from a text description of its timbre, age, and style, and returns a spoken preview.

Source: https://www.sandbase.ai/model/minimax/voice-design
API reference: https://www.sandbase.ai/model/minimax/voice-design/docs

## Facts

- Provider: MiniMax
- Type: Audio model
- Model ID: `minimax/voice-design`
- Price: From $3 per run
- Capabilities: text to speech
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

- Unified Run API: `POST https://api.sandbase.ai/v1/run`

```bash
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax/voice-design",
  "prompt": "Bubbly and excitable female pop star interviewee, youthful, slightly breathless, and very enthusiastic",
  "preview_text": "Oh my gosh, hi. It'"'"'s like so amazing to be here. This new endpoint just dropped on fal and the results have been like totally incredible. Use it now, It'"'"'s gonna be like epic!"
}'
```

The response returns a run id; poll `GET https://api.sandbase.ai/v1/run/{id}` until the status is `completed` or `failed`.

## FAQ

### How do I call MiniMax Voice Design through SandBase?

Create a SandBase API key, then send requests with the model ID "minimax/voice-design" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

### Do I need a separate MiniMax account?

No. One SandBase API key and balance gives you access to MiniMax Voice Design and the other models in the catalog; you do not need to sign up with MiniMax separately.

## README

### MiniMax Voice Design

Design a new reusable voice from a text description of its timbre, age, and style. The response includes the voice ID and a spoken preview.

#### Fields

| Field | Type | Default | Notes |
|---|---|---|---|
| `prompt` | string, required | — | Describe the voice: gender, age, timbre, accent, and mood. |
| `preview_text` | string | — | Sentence spoken in the new voice. |

#### Billing

$3.00 per designed voice plus $0.03 per started 1,000 description characters.

| Request | Price |
|---|---|
| One voice | $3.00 |

Failed runs are not charged.

#### Prompting

- Be concrete: “warm, low female voice in her 40s, slight British accent, calm”.

#### Limits

- Use the returned voice ID as `voice_id` in MiniMax Speech.

#### Also on SandBase

Related: `minimax/speech/2.8/hd`, `minimax/speech/2.8/turbo`, `minimax/voice-clone`.