StreamElements TTS
App · Video & Audio · 2 actions
Read text aloud in StreamElements' voices (including Brian, the voice of Twitch donation alerts) and save it as an MP3 your workflow can play or send.
Find voices
Look up which StreamElements voices speak a language, optionally narrowed to one gender. Use it when the language isn't known until the workflow runs: reading a viewer's message back in their own language, for example. The first match also comes back on its own as 'voice_id', ready to drop straight into Speak text.
Inputs
- Language
language_codetext - Only return voices that speak this language. Leave empty for every voice.
- Gender
gendertext - Only return voices of this gender. Leave empty for both.One of:
Female,Male.
Outputs
countnumbergendertextlanguagetextlanguage_codetextvoice_idtextvoice_nametextvoiceslist
Example output
{
"count": 2,
"gender": "Male",
"language": "English (UK)",
"language_code": "en-GB",
"voice_id": "Ali",
"voice_name": "Ali",
"voices": [
{
"gender": "Male",
"id": "Ali",
"language": "English (UK)",
"language_code": "en-GB",
"name": "Ali"
},
{
"gender": "Male",
"id": "Brian",
"language": "English (UK)",
"language_code": "en-GB",
"name": "Brian"
}
]
}Speak text
Read a line of text aloud in one of StreamElements' voices and save it as an MP3. The action returns a download URL and a document reference, so a later step can play it on an overlay, post it to chat, send it, or attach it to a message.
Inputs
- Voice
voicetextRequired - The voice to read the text in. Search the list by name, by language or by gender.
- Text
texttextRequired - What to say, up to 1000 characters.
Outputs
byte_sizenumbercharacter_countnumbercontent_typetextdocument_reftextdocumentslisttexttexturltextvoicetext
Example output
{
"byte_size": 14336,
"character_count": 22,
"content_type": "audio/mpeg",
"document_ref": "doc_4c1f7a2b9e0d5a63",
"documents": [
{
"content_type": "audio/mpeg",
"document_ref": "doc_4c1f7a2b9e0d5a63",
"filename": "streamelements-brian.mp3",
"size_bytes": 14336,
"url": "/actions/core/serve-document/doc_4c1f7a2b9e0d5a63?teamId=6512a1b2c3d4e5f600000001"
}
],
"text": "Thanks for the follow!",
"url": "/actions/core/serve-document/doc_4c1f7a2b9e0d5a63?teamId=6512a1b2c3d4e5f600000001",
"voice": "Brian"
}