- Voice description - A text description of the voice you have in mind (e.g., age, gender, accent, tone, pitch).
- Script - The text the voice will speak. This shapes the generated voice, so using a script that matches the intended voice produces the best results.
- Through Inworld Portal - Go to TTS Playground > Create Voice > Design and follow the guided flow.
- Via API or SDK - Useful if you want to generate a lot of voices or expose this capability to your users.
Design a Voice in Portal
Go to Inworld Portal
In Portal, select TTS Playground from the left-hand side panel. Click Create Voice and select Design.

Choose a mode
Voice Design has two modes, switchable with the tabs at the top:
- Freeform - Describe the voice in plain English and let us build the voice profile for you. The easiest option and the best starting point.
- Structured - Work on the structured voice profile itself — the exact prompt the model receives, one attribute per line.
Freeform: describe the voice
Describe the voice you want to create, in English, up to 1,000 characters — including the character, if you have one in mind. The preset chips (e.g. Agent, Narrator, Companion) give you a starting point to edit.Keep your description concise but specific, so the model can most accurately produce what you have in mind. A good voice description should include:
- Gender and age range (e.g., “a mid-20s to early 30s female voice”, “a middle-aged male voice”)
- Pitch and pace (e.g., “low-pitched”, “fast-paced”, “steady pace”)
- Tone and emotion (e.g., “warm and friendly”, “authoritative and composed”)
- Timbre (e.g., “rich and smooth”, “slightly raspy”, “clear and bright”)
Structured: edit the voice profile directly
In the Structured tab you edit the exact voice profile the model receives, one attribute per line: dialect, gender, age, emotion, tone, pitch, volume, speed, clarity, fluency, personality, texture, and environment. Edit any value, add your own lines, or start from a preset.The dialect line carries the language and accent. Clear resets the profile to the blank template.
Generate and preview voices
Click Generate voice, which will create up to 3 voice previews. Listen to each preview by clicking the play button, then select the voice(s) you want to keep.Each generation produces slightly different results. If the first set of voices doesn’t sound right, click Generate voice again to regenerate, or adjust your description or voice profile to better match what you have in mind before regenerating.
Save your voice
After selecting one or more voices, give each voice a name, add optional tags, and save them to your voice library. Your designed voices will appear alongside your other voices in the TTS Playground.
Use your voice via API
To use your designed voice via API, copy the voice ID from the TTS Playground. Use that value for the
voiceId when making an API call. See our Quickstart to learn how to make your first API call.Design a Voice with the SDK
You can also design voices programmatically usingdesignVoice() / design_voice() and publishVoice() / publish_voice() from the Inworld TTS SDK.
Voice Design API Reference And Examples
If you want to automate voice design (for example, to support creator onboarding at scale), use the Voice Design API.- Design a voice API reference: Design a voice
- Publish a voice API reference: Publish a voice
- Python example: example_voice_design_publish.py
- JavaScript example: example_voice_design_publish.js
Next Steps
Voice Design Best Practices
Learn best practices for designing voices.
Voice Cloning
Clone an existing voice with as little as 3 seconds of audio.
Quickstart
Learn how to make your first TTS API call in minutes.