# Minimax | Speech | 2.8 HD

MiniMax Speech 2.8 HD generates studio-quality AI voiceovers from text with multiple voice options for narration, podcasts, and accessibility content.

## API Information

- **Model Slug:** minimax-speech-2-8-hd
- **Branded URL:** https://www.eachlabs.ai/minimax/minimax-speech/minimax-speech-2-8-hd
- **Provider:** MiniMax
- **Category:** Text to Voice
- **Output Type:** audio
- **Status:** active
- **Version:** 0.0.1
- **Base Cost:** MiniMax Speech 2.8 HD: $0.10 per 1,000 characters of input prompt.
- **Estimated Processing Time:** 1 seconds
- **Last Updated:** 2026-07-13
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/minimax-speech-2-8-hd

## Pricing

- **Charge Type:** dynamic
- **Estimated Price (default example):** $0.0147
- **Pricing Details:** MiniMax Speech 2.8 HD: $0.10 per 1,000 characters of input prompt.

### Pricing Rules

| Condition | Pricing |
| --- | --- |
| Rule 1 | MiniMax Speech 2.8 HD: $0.10 per 1,000 characters of input prompt. |

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| prompt | string | Yes | - | - | Text to convert to speech. Use `<#x#>` for pauses (x = 0.01-99.99 seconds). Supports interjection tags: `(laughs)`, `(sighs)`, `(coughs)`, `(clears throat)`, `(gasps)`, `(sniffs)`, `(groans)`, `(yawns)`. |
| voice_setting | string | No | {'vol': 1, 'speed': 1, 'voice_id': 'Wise_Woman', 'pitch': 0, 'english_normalization': False} | - | Voice configuration settings |
| audio_setting | string | No | - | - | Audio configuration settings |
| language_boost | string | No | - | - | Enhance recognition of specified languages and dialects |
| output_format | string | No | hex | url, hex | Format of the output content (non-streaming only) |
| pronunciation_dict | string | No | - | - | Custom pronunciation dictionary for text replacement |
| normalization_setting | string | No | - | - | Loudness normalization settings for the audio |
| voice_modify | string | No | - | - | Voice modification settings to adjust pitch, intensity, and timbre. |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-speech-2-8-hd",
  "input": {
    "prompt": "Hey everyone! MiniMax Speech 2.8 HD is now available on Eachlabs. Crystal clear voices, natural emotion, and next-level expressiveness. Try it now!"
  }
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "string (URL of generated audio)",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "X-API-Key: YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `X-API-Key` |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

**Minimax | Speech | 2.8 HD Overview**

Minimax | Speech | 2.8 HD is a text-to-voice AI model that transforms written text into studio-quality voiceovers with natural prosody and emotional expression. Developed by Minimax, this model addresses a critical gap in content production: the need for professional-grade voice synthesis without expensive voice actors or recording studios. Unlike basic text-to-speech systems, Minimax | Speech | 2.8 HD delivers HD-quality audio suitable for commercial narration, podcasts, educational content, and accessibility applications. The model supports multiple voice options and languages, enabling creators to produce localized content at scale while maintaining consistent quality and natural-sounding delivery.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `X-API-Key: YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.