Documentation Index
Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt
Use this file to discover all available pages before exploring further.
Model ID
Inworld Realtime TTS 2 API Usage Guide
Overview
Inworld Realtime TTS 2 is Inworld’s next-generation text-to-speech model, delivering higher quality audio with lower latency. It supports the same 65 voices across 16 languages as TTS 1.5, with enhanced naturalness and expressiveness. Includes phoneme-level timing and viseme symbols for lip-sync animation.
Key Features:
- 65 Voices across 16 languages
- Higher Quality: Improved naturalness and expressiveness over TTS 1.5
- Lower Latency: Optimized for real-time applications
- Word & Character Timestamps: Optional alignment metadata for captions and highlights
- Multiple Formats: MP3, WAV, OGG_OPUS, FLAC, ALAW, MULAW
- Text Normalization: Automatic expansion of numbers, dates, abbreviations
Available Voices (65 total)
English (25 voices)
| Voice | Description | Tags |
|---|
| Alex | Energetic mid-range male | friendly, expressive |
| Ashley | Warm, natural female | warm, mellow |
| Blake | Rich, intimate male | intimate, romantic |
| Carter | Radio announcer-style male | intense, motivational |
| Clive | British male, calm | calm, friendly, british |
| Craig | Older British male, refined | posh, raspy, british |
| Deborah | Gentle, elegant female | gentle, elegant |
| Dennis | Smooth, calm male | outgoing, upbeat |
| Dominus | Robotic, deep male | robotic, monotone |
| Edward | Fast-talking, emphatic male | emphatic, shouty |
| Elizabeth | Professional female | informative, calm |
| Hades | Commanding, gruff male | commanding, gruff |
| Hana | Bright, expressive female | bright, playful |
| Julia | Quirky, high-pitched female | childish, quirky |
| Luna | Calm, relaxing female | calm, relaxing |
| Mark | Energetic male, rapid-fire | articulate, engaging |
| Olivia | British female, upbeat | cute, upbeat, british |
| Pixie | Childlike female | cartoonish, high-pitched |
| Priya | Female, Indian accent | friendly, gentle |
| Ronald | British male, deep voice | confident, expressive, british |
| Sarah | Young adult female | upbeat, excited |
| Shaun | Friendly, dynamic male | calm, casual |
| Theodore | Gravelly male, elderly | elderly, wise |
| Timothy | Lively American male | hyped, upbeat |
| Wendy | British female, posh | pleasant, casual, british |
Chinese 中文 (4 voices)
| Voice | Description | Tags |
|---|
| Yichen | 年轻男声 | clear, friendly |
| Xiaoyin | 年轻女声, 温柔 | polite, kind |
| Xinyi | 女声, 中性 | professional, warm |
| Jing | 活力女声 | soft, clear |
Japanese 日本語 (2 voices)
| Voice | Description | Tags |
|---|
| Asuka | 若い女性 | energetic, clear |
| Satoshi | 男性, 表現力豊か | nervous, curious |
Korean 한국어 (4 voices)
| Voice | Description | Tags |
|---|
| Hyunwoo | 젊은 남성 | polite, warm |
| Minji | 젊은 여성 | light, bright |
| Seojun | 성숙 남성 | deep, authoritative |
| Yoona | 여성, 부드러움 | sad, clear |
Other Languages
- French (4): Alain, Hélène, Mathieu, Étienne
- German (2): Johanna, Josef
- Spanish (4): Diego, Lupita, Miguel, Rafael
- Italian (2): Gianni, Orietta
- Portuguese-BR (2): Heitor, Maitê
- Russian (4): Svetlana, Elena, Dmitry, Nikolai
- Dutch (4): Erik, Katrien, Lennart, Lore
- Polish (2): Szymon, Wojciech
- Hindi (2): Riya, Manoj
- Hebrew (2): Yael, Oren
- Arabic (2): Nour, Omar
Authentication
All API requests require Bearer authentication:
Authorization: Bearer YOUR_API_KEY
Submit TTS Request
Endpoint
POST /api/v1/ie/requestqueue/apikey/requests
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "inworld-tts-2",
"payload": {
"text": "Hello, world! What a wonderful day!",
"voice_id": "Dennis",
"audio_encoding": "MP3",
"sample_rate_hertz": 48000,
"speaking_rate": 1.0,
"temperature": 1.1,
"timestamp_type": "WORD"
}
}'
Response
Inworld TTS 2 is synchronous and returns results immediately.
{
"request_id": "abc123-def456",
"model": "inworld-tts-2",
"status": "success",
"outcome": {
"audio_url": "https://storage.googleapis.com/...",
"media": [{"type": "audio", "url": "https://..."}],
"usage": {
"processed_characters": 35,
"model_id": "inworld-tts-2"
},
"timestamp_info": {
"wordAlignment": {
"words": ["Hello,", "world!"],
"wordStartTimeSeconds": [0, 0.37],
"wordEndTimeSeconds": [0.37, 0.83],
"phoneticDetails": [...]
}
}
}
}
