Inworld AI
Text-to-Speech platform with voice cloning, audio markups, and timestamp alignment.
Quick Navigation
| Topic |
Reference |
| Installation |
installation.md |
| Voice Cloning |
cloning.md |
| Voice Control |
voice-control.md |
| API Reference |
api.md |
When to Use
- Text-to-speech audio generation
- Voice cloning from 5-15 seconds of audio
- Emotion-controlled speech (
[happy], [sad], etc.)
- Word/phoneme timestamps for lip sync
- Custom pronunciation with IPA
Models
| Model |
ID |
Latency |
Price |
| TTS-2 Flash |
inworld-tts-2-flash |
lowest |
see pricing |
| TTS-2 |
inworld-tts-2 |
latest |
see pricing |
| TTS 1.5 Max |
inworld-tts-1.5-max |
legacy |
legacy |
| TTS 1.5 Mini |
inworld-tts-1.5-mini |
legacy |
legacy |
Minimal Example
import requests, base64, os
response = requests.post(
"https://api.inworld.ai/tts/v1/voice",
headers={"Authorization": f"Basic {os.getenv('INWORLD_API_KEY')}"},
json={"text": "Hello!", "voiceId": "Ashley", "modelId": "inworld-tts-1.5-max"}
)
audio = base64.b64decode(response.json()['audioContent'])
Key Features
- 15 languages — en, zh, ja, ko, ru, it, es, pt, fr, de, pl, nl, hi, he, ar
- Instant cloning — 5-15 seconds audio, no training
- Audio markups —
[happy], [laughing], [sigh] (English only)
- Timestamps — word, phoneme, viseme timing for lip sync
- Streaming —
/voice:stream endpoint
- TTS-2 steering — natural-language bracketed directions such as
[say excitedly] or [whisper in a hushed style]
- Delivery mode —
STABLE, BALANCED, CREATIVE trade consistency for emotional range
- Cross-lingual synthesis — reuse one voice across multiple languages; voice localization improves native-sounding output
Release Highlights (TTS-2)
Realtime TTS-2 becomes the new primary model line via modelId="inworld-tts-2".
- Steering moves beyond the older fixed emotion tags: free-form bracketed directions can control style, pitch, speed, intensity, and non-verbals.
- Multilingual coverage expands with production quality across 15 languages and broader experimental coverage beyond that.
deliveryMode adds a stability-vs-creativity knob, and specifying language matters more for cross-lingual output quality.
Release Updates (August 2026)
- New
inworld-tts-2-flash model: lowest latency and cost, full language coverage, instant voice cloning, and timestamp alignment. Steering and Professional Voice Cloning remain exclusive to inworld-tts-2.
- Steering instructions now persist until explicitly changed: a reserved
[reset] tag ends a styled passage, and a <break/> pause no longer clears the active instruction. A request-level instruction field on Synthesize Speech is an alternative to inline tags.
- Cross-lingual voice synthesis and voice localization improve native-sounding output when one voice is reused across languages.
Prohibitions
- Audio markups work only in English
- Use ONE emotion markup at text beginning
- Match voice language to text language
- Instant cloning may not work for children's voices or unique accents
Links
1---2name: inworld3description: Inworld TTS API. Covers voice cloning, audio markups, timestamps. Use when integrating Inworld text-to-speech, cloning voices, adding audio markups (SSML-like), or aligning viseme timestamps. Keywords: Inworld, text-to-speech, TTS, voice cloning, visemes.4---5
6# Inworld AI
7
8Text-to-Speech platform with voice cloning, audio markups, and timestamp alignment.
9
10## Quick Navigation
11
12| Topic | Reference |
13| ------------- | ----------------------------------------------- |
14| Installation | [installation.md](references/installation.md) |
15| Voice Cloning | [cloning.md](references/cloning.md) |
16| Voice Control | [voice-control.md](references/voice-control.md) |
17| API Reference | [api.md](references/api.md) |
18
19## When to Use
20
21- Text-to-speech audio generation
22- Voice cloning from 5-15 seconds of audio
23- Emotion-controlled speech (`[happy]`, `[sad]`, etc.)
24- Word/phoneme timestamps for lip sync
25- Custom pronunciation with IPA
26
27## Models
28
29| Model | ID | Latency | Price |
30| ------------ | ---------------------- | ------- | ----------- |
31| TTS-2 Flash | `inworld-tts-2-flash` | lowest | see pricing |
32| TTS-2 | `inworld-tts-2` | latest | see pricing |
33| TTS 1.5 Max | `inworld-tts-1.5-max` | legacy | legacy |
34| TTS 1.5 Mini | `inworld-tts-1.5-mini` | legacy | legacy |
35
36## Minimal Example
37
38```python
39import requests, base64, os
40
41response = requests.post(
42 "https://api.inworld.ai/tts/v1/voice",
43 headers={"Authorization": f"Basic {os.getenv('INWORLD_API_KEY')}"},
44 json={"text": "Hello!", "voiceId": "Ashley", "modelId": "inworld-tts-1.5-max"}
45)
46audio = base64.b64decode(response.json()['audioContent'])
47```
48
49## Key Features
50
51- **15 languages** — en, zh, ja, ko, ru, it, es, pt, fr, de, pl, nl, hi, he, ar
52- **Instant cloning** — 5-15 seconds audio, no training
53- **Audio markups** — `[happy]`, `[laughing]`, `[sigh]` (English only)
54- **Timestamps** — word, phoneme, viseme timing for lip sync
55- **Streaming** — `/voice:stream` endpoint
56- **TTS-2 steering** — natural-language bracketed directions such as `[say excitedly]` or `[whisper in a hushed style]`
57- **Delivery mode** — `STABLE`, `BALANCED`, `CREATIVE` trade consistency for emotional range
58- **Cross-lingual synthesis** — reuse one voice across multiple languages; voice localization improves native-sounding output
59
60## Release Highlights (TTS-2)
61
62- `Realtime TTS-2` becomes the new primary model line via `modelId="inworld-tts-2"`.
63- Steering moves beyond the older fixed emotion tags: free-form bracketed directions can control style, pitch, speed, intensity, and non-verbals.
64- Multilingual coverage expands with production quality across 15 languages and broader experimental coverage beyond that.
65- `deliveryMode` adds a stability-vs-creativity knob, and specifying `language` matters more for cross-lingual output quality.
66
67## Release Updates (August 2026)
68
69- New `inworld-tts-2-flash` model: lowest latency and cost, full language coverage, instant voice cloning, and timestamp alignment. Steering and Professional Voice Cloning remain exclusive to `inworld-tts-2`.
70- Steering instructions now persist until explicitly changed: a reserved `[reset]` tag ends a styled passage, and a `<break/>` pause no longer clears the active instruction. A request-level `instruction` field on Synthesize Speech is an alternative to inline tags.
71- Cross-lingual voice synthesis and voice localization improve native-sounding output when one voice is reused across languages.
72
73## Prohibitions
74
75- Audio markups work **only in English**
76- Use **ONE** emotion markup at text **beginning**
77- Match voice language to text language
78- Instant cloning may not work for children's voices or unique accents
79
80## Links
81
82- [Documentation](https://docs.inworld.ai/docs/tts/tts)
83- [Changelog](https://docs.inworld.ai/docs/release-notes/tts)
84- [Platform](https://platform.inworld.ai/)