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