> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runpod.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Minimax Speech 02 HD

> High-definition text-to-speech with emotional control and voice customization.

Minimax Speech 02 HD is a high-definition text-to-speech model with emotional control and voice customization. It produces natural-sounding speech with adjustable speed, pitch, volume, and emotional tone.

<Card title="Try in playground" icon="play" href="https://console.runpod.io/hub/playground/audio/minimax-speech-02-hd" horizontal>
  Test Minimax Speech 02 HD in the Runpod Hub playground.
</Card>

|              |                                                         |
| ------------ | ------------------------------------------------------- |
| **Endpoint** | `https://api.runpod.ai/v2/minimax-speech-02-hd/runsync` |
| **Pricing**  | \$0.05 per 1000 characters                              |
| **Type**     | Text-to-speech                                          |

## Request

All parameters are passed within the `input` object in the request body.

<ParamField body="input.prompt" type="string" required>
  Text to convert to speech.
</ParamField>

<ParamField body="input.voice_id" type="string" default="Wise_Woman">
  Voice identifier for the desired voice.
</ParamField>

<ParamField body="input.speed" type="number" default="1">
  Speech speed multiplier.
</ParamField>

<ParamField body="input.volume" type="number" default="1">
  Volume level.
</ParamField>

<ParamField body="input.pitch" type="number" default="0">
  Pitch adjustment.
</ParamField>

<ParamField body="input.emotion" type="string" default="neutral">
  Emotion to convey. Options include `happy`, `sad`, `neutral`, `angry`, `fearful`, `surprised`.
</ParamField>

<ParamField body="input.english_normalization" type="boolean" default="false">
  Enable English text normalization for better pronunciation of numbers, abbreviations, etc.
</ParamField>

<ParamField body="input.default_audio_url" type="string">
  Fallback audio URL if generation fails.
</ParamField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl -X POST "https://api.runpod.ai/v2/minimax-speech-02-hd/runsync" \
    -H "Authorization: Bearer $RUNPOD_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "input": {
        "prompt": "Welcome to our advanced text-to-speech system. This is a demonstration of natural speech synthesis.",
        "voice_id": "Wise_Woman",
        "speed": 1,
        "volume": 1,
        "pitch": 0,
        "emotion": "happy",
        "english_normalization": false
      }
    }'
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import requests

  response = requests.post(
      "https://api.runpod.ai/v2/minimax-speech-02-hd/runsync",
      headers={
          "Authorization": f"Bearer {RUNPOD_API_KEY}",
          "Content-Type": "application/json",
      },
      json={
          "input": {
              "prompt": "Welcome to our advanced text-to-speech system. This is a demonstration of natural speech synthesis.",
              "voice_id": "Wise_Woman",
              "speed": 1,
              "volume": 1,
              "pitch": 0,
              "emotion": "happy",
              "english_normalization": False,
          }
      },
  )

  result = response.json()
  print(result["output"]["audio_url"])
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const response = await fetch(
    "https://api.runpod.ai/v2/minimax-speech-02-hd/runsync",
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${RUNPOD_API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        input: {
          prompt: "Welcome to our advanced text-to-speech system. This is a demonstration of natural speech synthesis.",
          voice_id: "Wise_Woman",
          speed: 1,
          volume: 1,
          pitch: 0,
          emotion: "happy",
          english_normalization: false,
        },
      }),
    }
  );

  const result = await response.json();
  console.log(result.output.audio_url);
  ```
</RequestExample>

## Response

<ResponseField name="id" type="string">
  Unique identifier for the request.
</ResponseField>

<ResponseField name="status" type="string">
  Request status. Returns `COMPLETED` on success, `FAILED` on error.
</ResponseField>

<ResponseField name="delayTime" type="integer">
  Time in milliseconds the request spent in queue before processing began.
</ResponseField>

<ResponseField name="executionTime" type="integer">
  Time in milliseconds the model took to generate the audio.
</ResponseField>

<ResponseField name="workerId" type="string">
  Identifier of the worker that processed the request.
</ResponseField>

<ResponseField name="output" type="object">
  The generation result containing the audio URL and cost.

  <ResponseField name="output.audio_url" type="string">
    URL of the generated audio file. This URL expires after 7 days.
  </ResponseField>

  <ResponseField name="output.cost" type="float">
    Cost of the generation in USD.
  </ResponseField>
</ResponseField>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "id": "sync-a1b2c3d4-e5f6-7890-abcd-ef1234567890-u1",
    "status": "COMPLETED",
    "delayTime": 14,
    "executionTime": 3456,
    "workerId": "oqk7ao1uomckye",
    "output": {
      "audio_url": "https://audio.runpod.ai/abc123/output.mp3",
      "cost": 0.0055
    }
  }
  ```

  ```json 400 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "id": "sync-a1b2c3d4-e5f6-7890-abcd-ef1234567890-u1",
    "status": "FAILED",
    "error": "Invalid voice_id"
  }
  ```
</ResponseExample>

<Warning>
  Audio URLs expire after 7 days. Download and store generated audio files immediately if you need to keep them.
</Warning>

## Cost calculation

Minimax Speech 02 HD charges \$0.05 per 1000 characters. Example costs:

| Characters        | Cost    |
| ----------------- | ------- |
| 500 characters    | \$0.025 |
| 1,000 characters  | \$0.05  |
| 10,000 characters | \$0.50  |