# MiniMax Speech-02-Turbo - Core.Today AI API

> Low-latency text-to-speech model with multilingual support, emotional voice control, and 300+ voice options.

- **Provider**: MiniMax
- **Model ID**: minimax/speech-02-turbo
- **Category**: Audio & TTS
- **Credits**: 142 per 1000 characters (0.135 credits/char, billed per character)
- **Speed**: Fast
- **Quality**: High

## Features
- Low-latency real-time synthesis
- 300+ voice presets
- Emotional expression control
- Multilingual support
- Voice cloning compatible

## Use Cases
- Real-time voice assistants
- Interactive applications
- Live streaming content
- Customer service bots
- Game character voices

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **text**: string - Text to narrate (max 10,000 characters)

### Optional
- **voice_id**: string (default: English_Wiselady) - Voice preset or cloned voice ID
- **speed**: number (default: 1) - Speech speed multiplier (0.5-2.0)
- **volume**: number (default: 1) - Relative loudness. 1.0 is default MiniMax gain. Range 0–10.
- **pitch**: integer (default: 0) - Semitone offset applied to the voice (−12 to +12).
- **emotion**: string (default: auto) - Delivery style
  Options: auto, happy, sad, angry, fearful, disgusted, surprised, calm, fluent, neutral
- **english_normalization**: boolean (default: false) - Improve number/date reading for English text (adds a small amount of latency).
- **sample_rate**: integer (default: 32000) - Audio sample rate in Hz.
  Options: 8000, 16000, 22050, 24000, 32000, 44100
- **bitrate**: integer (default: 128000) - MP3 bitrate in bits per second. Only used when audio_format is mp3.
  Options: 32000, 64000, 128000, 256000
- **audio_format**: string (default: mp3) - File format for the generated audio. Choose mp3 for general use, wav/flac for lossless, or pcm for raw bytes.
  Options: mp3, wav, flac, pcm
- **channel**: string (default: mono) - mono for 1 channel (default), stereo for 2 channels.
  Options: mono, stereo
- **subtitle_enable**: boolean (default: false) - Reserved: the upstream currently returns audio only — no subtitle data is included even when enabled
- **language_boost**: string (default: None) - Language hint for better pronunciation
  Options: None, Automatic, Chinese, Chinese,Yue, Cantonese, 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, Persian, Slovak, Swedish, Croatian, Filipino, Hungarian, Norwegian, Slovenian, Catalan, Nynorsk, Tamil, Afrikaans

## Examples

### Voice Assistant Greeting
Generate a friendly assistant greeting with emotion
```json
{
  "model": "minimax/speech-02-turbo",
  "input": {
    "text": "안녕하세요! 코어닷투데이에 오신 것을 환영합니다. 무엇을 도와드릴까요?",
    "voice_id": "Korean_CalmLady",
    "emotion": "happy",
    "speed": 1,
    "language_boost": "Korean"
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

## Tips
- Use emotion 'auto' to let the model detect the best tone from context
- Keep text under 10,000 characters per request for optimal performance
- Set language_boost for non-English text to improve pronunciation accuracy
- Adjust speed between 0.8-1.2 for the most natural-sounding results
- subtitle_enable is accepted but the upstream does not return subtitle data yet — responses contain audio only

## Documentation
https://platform.minimax.io/docs/api-reference/speech-t2a-intro