> ## 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.

# Realtime-tts-1.5-max

> API usage guide for Realtime-tts-1.5-max.

{/* source_model_id: inworld-tts-1.5-max */}

{/* source_updated_at: 1769820078 */}

**Model ID**

```bash theme={null}
inworld-tts-1.5-max
```

**Calling method:** sync

# Inworld TTS 1.5 Max API Usage Guide

## Overview

**Inworld TTS 1.5 Max** is a high-quality text-to-speech model with enhanced alignment data, including detailed phoneme-level timing and viseme symbols for lip-sync animation.

### Key Features:

* **65 Voices** across 16 languages
* **Enhanced Alignment**: Detailed `phoneticDetails` with phoneme-level timing
* **Viseme Symbols**: Direct lip-sync animation support (aei, o, bmp, fv, l, r, th, qw, ee, cdgknstxyz)
* **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 Basic authentication:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Submit TTS Request

### Endpoint

```
POST /api/v1/ie/requestqueue/apikey/requests
```

### Request Format

```bash theme={null}
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-1.5-max",
    "payload": {
      "text": "Hello, world! What a wonderful day!",
      "voice_id": "Dennis",
      "audio_encoding": "MP3",
      "sample_rate_hertz": 22050,
      "speaking_rate": 1.0,
      "temperature": 1.1,
      "timestamp_type": "WORD"
    }
  }'
```

## Response

Inworld TTS is **synchronous** and returns results immediately.

```json theme={null}
{
    "request_id": "abc123-def456",
    "model": "inworld-tts-1.5-max",
    "status": "success",
    "outcome": {
        "audio_url": "https://storage.googleapis.com/...",
        "media": [{"type": "audio", "url": "https://..."}],
        "usage": {
            "processed_characters": 35,
            "model_id": "inworld-tts-1.5-max"
        },
        "timestamp_info": {
            "wordAlignment": {
                "words": ["Hello,", "world!"],
                "wordStartTimeSeconds": [0, 0.37],
                "wordEndTimeSeconds": [0.37, 0.83],
                "phoneticDetails": [...]
            }
        }
    }
}
```

## Pricing

* **Pricing Type**: Per character
* **Price**: Contact for pricing
* **Unit**: Characters