Skip to main content
GET
/
tts
/
v1
/
voice:preview
cURL
curl 'https://api.inworld.ai/tts/v1/voice:preview?voice_id=Ashley&model_id=inworld-tts-2' \
--header "Authorization: Basic $INWORLD_API_KEY" \
| jq -r '.audioContent' | base64 -d > preview.mp3
{
  "audioContent": "SUQzBAAAAAAAI1RTU0UAAAAPAAADTGF2ZjYwLjE2LjEwMAAAAAAAAAAAAAAA..."
}

Authorizations

​
Authorization
string
header
required

Your authentication credentials. For Basic authentication, please populate Basic $INWORLD_API_KEY. You can create a key in one command with the Inworld CLI: inworld workspace add-key.

Query Parameters

​
voice_id
string
required

The identifier of the voice to preview. Use the List Voices endpoint to discover available voice IDs.

Example:

"Ashley"

​
model_id
string
required

The identifier of the TTS model to use for generating the preview. See Models for available models.

Example:

"inworld-tts-2"

Response

A successful response containing the voice preview audio.

​
audioContent
string<byte>

The audio data bytes encoded as MP3. The preview text is determined server-side and cannot be customized.