# MiniMax Speech 2.8 HD API

> Ubadilishaji wa maandishi kuwa sauti wa MiniMax wa ubora wa juu katika lugha 30+, wenye kusitisha, hisia na udhibiti wa matamshi.

MiniMax Speech 2.8 HD hutamka maandishi katika zaidi ya lugha 30 kwa udhibiti wa kina: alama za kusitisha ndani ya maandishi, kasi ya sauti, toni na ujazo, kamusi maalum za matamshi na athari za sauti. Chagua kati ya sauti zilizojumuishwa na kiwango cha sampuli na umbizo la matokeo.

- Model id: `minimax/speech-2.8-hd`
- Made by: MiniMax
- Category: Text to Speech
- Output: audio
- Price: $0.10 / 1000 characters (cheapest run $0.10 (100 API credits))
- Run: `POST https://api.doitong.com/v1/run/minimax/speech-2.8-hd`
- Quote: `POST https://api.doitong.com/v1/quote/minimax/speech-2.8-hd`
- Docs page: https://doitong.com/sw/developers/models/minimax/speech-2.8-hd

## Pricing

Price: **$0.10 / 1000 characters**. Billed per character of `prompt` (the price is per 1000 characters).

The full example input below costs $0.008 = 8 API credits (79 characters × 100 API credits / 1000 characters).

Prices are the upstream price in USD, paid from the API balance in API credits (1000 API credits = 1 USD). `POST https://api.doitong.com/v1/quote/minimax/speech-2.8-hd` with the same JSON body returns the exact price for that input; the quote is exactly what a run charges. Invalid input is never charged and failed or canceled requests are refunded automatically.

## Input parameters

| Parameter | Canonical name | Type | Required | Default | Allowed values / range | Description |
|---|---|---|---|---|---|---|
| `prompt` |  | string | yes |  | 1 – 10000 characters | Maandishi ya usanisi wa usemi, yenye mapumziko yaliyobainishwa na `<#x#>` ambapo x huanzia 0.01 hadi 99.99 sekunde. Alama za viingilizi zinazopatikana ni `(laughs)`, `(sighs)`, `(coughs)`, `(clears throat)`, `(gasps)`, `(sniffs)`, `(groans)`, na `(yawns)`. |
| `voice_setting` |  | object {voice_id, speed, vol, pitch, emotion, english_normalization} | no | `{"english_normalization":false,"pitch":0,"speed":1,"voice_id":"Wise_Woman","vol":1}` |  | Mipangilio ya kusanidi sauti. |
| `voice_setting.voice_id` |  | string | no | `Wise_Woman` | ≥ 1 characters | Kitambulisho cha sauti kilichobainishwa awali kinachotumika kwa usanisi wa usemi. |
| `voice_setting.speed` |  | number | no | `1` | 0.5 – 2 | Kasi ya kuzungumza, kuanzia 0.5 hadi 2.0. |
| `voice_setting.vol` |  | number | no | `1` | 0.01 – 10 | Sauti ya tokeo, kuanzia 0 hadi 10. |
| `voice_setting.pitch` |  | integer | no | `0` | -12 – 12 | Pitch ya sauti, kuanzia -12 hadi 12. |
| `voice_setting.emotion` |  | enum (string) \| null | no |  | `happy`, `sad`, `angry`, `fearful`, `disgusted`, `surprised`, `neutral` | Toni ya kihisia ya usemi uliosanisishwa. |
| `voice_setting.english_normalization` |  | boolean | no | `false` |  | Chaguo la kusanifisha maandishi ya Kiingereza linalobadilisha kiasi kidogo cha ucheleweshaji wa ziada kwa usomaji bora wa nambari. |
| `audio_setting` |  | object {sample_rate, bitrate, format, channel} | no |  |  | Mipangilio ya kusanidi sauti. |
| `audio_setting.sample_rate` |  | enum (integer) | no | `32000` | `8000`, `16000`, `22050`, `24000`, `32000`, `44100` | Kiwango cha sampuli cha sauti inayozalishwa. |
| `audio_setting.bitrate` |  | enum (integer) | no | `128000` | `32000`, `64000`, `128000`, `256000` | Kiwango cha biti cha sauti inayozalishwa. |
| `audio_setting.format` |  | enum (string) | no | `mp3` | `mp3`, `pcm`, `flac` | Umbizo la sauti. |
| `audio_setting.channel` |  | enum (integer) | no | `1` | `1`, `2` | Idadi ya njia za sauti: 1 kwa mono au 2 kwa stereo. |
| `language_boost` |  | enum (string) \| null | no |  | `Chinese`, `Chinese,Yue`, `English`, `Arabic`, `Russian`, `Spanish`, `French`, `Portuguese`, `German`, `Turkish`, `Dutch`, `Ukrainian`, `Vietnamese`, `Indonesian`, `Japanese`, `Italian`, `Korean`, `Thai`, `Polish`, `Romanian`, `Greek`, `Czech`, `Finnish`, `Hindi`, `Bulgarian`, `Danish`, `Hebrew`, `Malay`, `Slovak`, `Swedish`, `Croatian`, `Hungarian`, `Norwegian`, `Slovenian`, `Catalan`, `Nynorsk`, `Afrikaans`, `auto` | Huboresha utambuzi kwa lugha na lahaja zilizochaguliwa. |
| `output_format` |  | enum (string) | no | `hex` | `url`, `hex` | Umbizo la maudhui ya tokeo; hutumika tu kwa majibu yasiyotiririshwa. |
| `pronunciation_dict` |  | object {tone_list} \| null | no |  |  | Kamusi maalum ya matamshi inayotumika kubadilisha maandishi. |
| `pronunciation_dict.tone_list` |  | array of string | no |  |  | Orodha ya vibadilisho vya matamshi inayotumia sintaksia ['text/(pronunciation)', ...], kwa mfano ['燕少飞/(yan4)(shao3)(fei1)']. Nambari za toni za Kichina huanzia 1 hadi 5. |
| `normalization_setting` |  | object {enabled, target_loudness, target_range, target_peak} | no |  |  | Mipangilio inayodhibiti usanifishaji wa sauti. |
| `normalization_setting.enabled` |  | boolean | no | `true` |  | Huwasha usanifishaji wa sauti. |
| `normalization_setting.target_loudness` |  | number | no | `-18` | -70 – -10 | Sauti inayotakiwa, inayopimwa kwa LUFS; chaguomsingi ni -18.0. |
| `normalization_setting.target_range` |  | number | no | `8` | 0 – 20 | Masafa ya sauti yanayotakiwa, yanayopimwa kwa LU; chaguomsingi ni 8.0. |
| `normalization_setting.target_peak` |  | number | no | `-0.5` | -3 – 0 | Kiwango cha kilele kinachotakiwa, kinachopimwa kwa dBTP; chaguomsingi ni -0.5. |
| `voice_modify` |  | object {pitch, intensity, timbre} \| null | no |  |  | Mipangilio ya kurekebisha toni, nguvu na timbre ya sauti. |
| `voice_modify.pitch` |  | integer | no | `0` | -100 – 100 | Udhibiti wa toni unaopimwa kwa semitoni: tumia thamani hasi kushusha sauti au thamani chanya kuiinua. Thamani zinazoruhusiwa ni -100 hadi 100. |
| `voice_modify.intensity` |  | integer | no | `0` | -100 – 100 | Udhibiti wa nguvu ya sauti unaofanya usemi uwe na nguvu zaidi kadiri mpangilio unavyoongezeka. Masafa yake yanayoruhusiwa ni -100 hadi 100. |
| `voice_modify.timbre` |  | integer | no | `0` | -100 – 100 | Marekebisho ya timbre ya sauti kutoka -100 hadi 100, yanayodhibiti sifa yake ya toni. |

## Example input

Required parameters only:

```json
{
  "prompt": "Hello! Welcome to our new studio. <#0.5#> Let's make something wonderful today."
}
```

A fuller example:

```json
{
  "prompt": "Hello! Welcome to our new studio. <#0.5#> Let's make something wonderful today."
}
```

## Run it

Set `DOITONG_API_KEY` to a key from https://doitong.com/developers/dashboard#keys. `?wait=20` returns the finished request in the same call when it is ready within 20 seconds; otherwise poll `GET /requests/{id}` (it also accepts `?wait=`), or pass `webhook_url`.

### curl

```bash
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/minimax/speech-2.8-hd?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Hello! Welcome to our new studio. <#0.5#> Let'\''s make something wonderful today."
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"
```

### JavaScript

```javascript
const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/minimax/speech-2.8-hd?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "Hello! Welcome to our new studio. <#0.5#> Let's make something wonderful today."
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
```

### Python

```python
import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "Hello! Welcome to our new studio. <#0.5#> Let's make something wonderful today.",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/minimax/speech-2.8-hd", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
```

### MCP

The MCP server at `https://api.doitong.com/v1/mcp` exposes the tools `search_models`, `get_model`, `quote`, `run`, `get_request`, `cancel_request`, `list_requests`, `create_upload` and `get_account`. A `run` call for this model:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "minimax/speech-2.8-hd",
      "input": {
        "prompt": "Hello! Welcome to our new studio. <#0.5#> Let's make something wonderful today."
      },
      "wait_seconds": 20
    }
  }
}
```

## Response

Every call returns a request object. `status` is one of `queued`, `running`, `succeeded`, `failed`, `canceled`. `outputs` lists the generated files with URLs on our storage (kept forever, or 7 days with `?storage=temporary`; `storage` says which); `output` is the model's own result object with the same URLs.

```json
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "minimax/speech-2.8-hd",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 8,
    "usd": "0.008",
    "charged": 8,
    "refunded": 0
  },
  "input": {
    "prompt": "Hello! Welcome to our new studio. <#0.5#> Let's make something wonderful today."
  },
  "output": {
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_name": "0-output.mp3",
      "file_size": 1843200
    },
    "duration_ms": 1
  },
  "outputs": [
    {
      "type": "audio",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_size": 1843200,
      "duration": 12,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
```

### Output fields (`output`)

| Field | Type | Description |
|---|---|---|
| `audio` | object {url, content_type, file_name, file_size} | Faili ya sauti iliyotengenezwa kupitia uzalishaji. |
| `duration_ms` | integer | Urefu wa sauti, unaopimwa kwa milisekunde. |

## Related models

- [MiniMax Speech 2.6 \[HD\]](https://doitong.com/developers/models/minimax/speech-2.6-hd.md) (`minimax/speech-2.6-hd`): $0.10 / 1000 characters
- [MiniMax Speech 2.6 \[Turbo\]](https://doitong.com/developers/models/minimax/speech-2.6-turbo.md) (`minimax/speech-2.6-turbo`): $0.06 / 1000 characters
- [MiniMax Speech 2.8 \[Turbo\]](https://doitong.com/developers/models/minimax/speech-2.8-turbo.md) (`minimax/speech-2.8-turbo`): $0.06 / 1000 characters
- [MiniMax Speech-02 HD](https://doitong.com/developers/models/minimax/speech-02-hd.md) (`minimax/speech-02-hd`): $0.10 / 1000 characters
- [MiniMax Speech-02 Turbo](https://doitong.com/developers/models/minimax/speech-02-turbo.md) (`minimax/speech-02-turbo`): $0.06 / 1000 characters
- [MiniMax Voice Cloning](https://doitong.com/developers/models/minimax/voice-clone.md) (`minimax/voice-clone`): $1.5198 / run
- [MiniMax Voice Design](https://doitong.com/developers/models/minimax/voice-design.md) (`minimax/voice-design`): $3.00 / run
- [Eleven v4 Text to Speech](https://doitong.com/developers/models/elevenlabs/tts/eleven-v4.md) (`elevenlabs/tts/eleven-v4`): $0.08 / 1000 characters

## Links

- HTML page: https://doitong.com/developers/models/minimax/speech-2.8-hd
- All models and guides for AI agents: https://doitong.com/developers/llms.txt
- OpenAPI 3.1 with this model's typed request body: https://doitong.com/developers/openapi.json?model=minimax/speech-2.8-hd
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.com/v1/models/minimax/speech-2.8-hd