---
title: "Run MiniMax Speech-2.5 Turbo Preview (minimax-speech-25-turbo-preview)"
method: POST
path: "/models/minimax-speech-25-turbo-preview"
tags: ["Run a model"]
---

# Run MiniMax Speech-2.5 Turbo Preview (minimax-speech-25-turbo-preview)

`POST /models/minimax-speech-25-turbo-preview`

## Request

- Base URL: `https://api.hedra.com/v3`
- URL: `https://api.hedra.com/v3/models/minimax-speech-25-turbo-preview`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

The value tier — natural English delivery across 40+ languages, at a lower rate.

Submits an asynchronous job and returns `202` with a job id. Fetch the result at `GET /v3/jobs/{job_id}` — each item in its `outputs[]` follows the `OutputItem` schema — or track progress via `GET /v3/jobs/{job_id}/status` / the SSE stream at `GET /v3/jobs/{job_id}/stream`.

## Headers

- `Idempotency-Key` string

## Request body

- SubmitBodyMinimaxSpeech25TurboPreview
  - `input` InputMinimaxSpeech25TurboPreview, required: Model-specific inputs for `minimax-speech-25-turbo-preview`.
    - `text` string, required: Generation prompt. At most 9999 characters.
    - `stability` number: Voice stability. Higher values give a steadier, more consistent delivery; lower values allow more expressive variation between generations. From 0 to 1.
    - `speed` number: Speech rate multiplier; 1.0 is the voice's natural pace. From 0.7 to 1.2.
    - `language` 'auto' | 'zh' | 'yue' | 'en' | 'ar' | 'ru' | 'es' | 'fr' | 'pt' | 'de' | 'tr' | 'nl' | 'uk' | 'vi' | 'id' | 'ja' | 'it' | 'ko' | 'th' | 'pl' | 'ro' | 'el' | 'cs' | 'fi' | 'hi' | 'bg' | 'da' | 'he' | 'ms' | 'fa' | 'sk' | 'sv' | 'hr' | 'fil' | 'hu' | 'no' | 'sl' | 'ca' | 'nn' | 'ta' | 'af': Language of the text, as an ISO 639-1 code such as 'ko' ('yue' for Cantonese, 'fil' for Filipino), or 'auto' to detect it from the text. Omitted means 'auto'. Regional tags such as 'pt-BR' and English names such as 'Korean' are also accepted.
    - `voice_id` string, required: Voice to speak with (`voice_<uuid>`). List the voices you can use at GET /v3/models/minimax-speech-25-turbo-preview/voices.
  - `webhook` string, uri, nullable: URL to receive a signed completion webhook.

## Response `202`

Accepted. The job runs asynchronously; poll `status_url` / `result_url` from the ack.

- SubmitResponse
  - `job_id` string, required: This job's id — server-issued, and opaque.
  - `model` string, required: The resolved model id this job runs on.
  - `status` 'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: The four states a job can be in.
  - `status_url` string, required: Path of this job's status monitor: poll GET /v3/jobs/{job_id}/status for status, progress, and the estimated completion time.
  - `result_url` string, required: Path of the job resource itself: GET /v3/jobs/{job_id} returns the result envelope, including the outputs once it completes. Also the value of this response's `Location` header.
  - `estimated_completion_at` string, date-time, nullable: ISO-8601 instant this job is estimated to finish, as of this response. Null when no estimate is available yet, and when the job has already finished. The estimate can change while the job runs: poll `GET /v3/jobs/{job_id}/status` for the current one.

## Other responses

- `400`: Invalid or failed-validation request.
- `401`: Authentication failed: missing, malformed, or invalid credentials.
- `402`: The API wallet cannot cover this request. `error.billing` carries the balance, the price, and where to add funds.
- `403`: Insufficient scope or plan.
- `404`: Resource not found.
- `422`: Moderation refused the request's content.
- `429`: Rate limit exceeded.
- `500`: Internal error.

## Changes

- **2026-10-16** `06692d16e78a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hedra-labs/apis/hedra-api/changes/models/minimax-speech-25-turbo-preview/post.md)

---

[API](https://skmtc.dev/hedra-labs/apis/hedra-api.md) - [All operations](https://skmtc.dev/hedra-labs/apis/hedra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hedra-labs/apis/hedra-api/revisions/6ef35a11cefe?raw)