Voice Agent Nodes
Text-to-speech through the voice agent: resolve voices (including the narrator's), unpack voice data and generate speech.
5 nodes.
| Node | Registry path |
|---|---|
| Generate TTS | agents/tts/Generate |
| Get Narrator Voice | agents/tts/GetNarratorVoice |
| Get Voice | agents/tts/GetVoice |
| TTS Agent Settings | agents/tts/Settings |
| Unpack Voice | agents/tts/UnpackVoice |
Generate TTS
agents/tts/Generate
Generates speech audio for the given text via the TTS agent and queues it for playback in the frontend. Either a voice or a character must be provided; when a character is given its assigned voice is used, while an explicit voice input overrides it. Does nothing when the TTS agent is disabled or not ready.
Inputs
| Input | Type | Description |
|---|---|---|
state |
any |
The graph state |
text |
text |
(optional) The text to speak (required at runtime despite the optional socket) |
voice |
tts/voice |
The voice to use (optional) |
character |
character |
The character to speak as (optional) |
Outputs
| Output | Type | Description |
|---|---|---|
state |
any |
The state input, passed through |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
text |
text |
unset |
The text to generate |
Get Narrator Voice
agents/tts/GetNarratorVoice
Gets the narrator voice from the TTS agent.
Outputs
| Output | Type | Description |
|---|---|---|
voice |
tts/voice |
Get Voice
agents/tts/GetVoice
Looks up a voice in the TTS agent's voice library by voice ID.
Inputs
| Input | Type | Description |
|---|---|---|
voice_id |
str |
(optional) The ID of the voice to get (required at runtime despite the optional socket) |
Outputs
| Output | Type | Description |
|---|---|---|
voice |
tts/voice |
The voice object (None if no voice with that ID exists) |
Properties
| Property | Type | Default | Description |
|---|---|---|---|
voice_id |
str |
unset |
The ID of the voice to get |
TTS Agent Settings
agents/tts/Settings
Base node to render TTS agent settings.
Every setting of the tts agent is exposed as an output socket named after the setting - see the agent's documentation under Agents for what each setting does.
Unpack Voice
agents/tts/UnpackVoice
Unpacks a voice object into its individual fields.
Inputs
| Input | Type | Description |
|---|---|---|
voice |
tts/voice |
The voice to unpack |
Outputs
| Output | Type | Description |
|---|---|---|
voice |
tts/voice |
The voice, passed through |
label |
str |
The voice's display label |
provider |
str |
The TTS provider (API) the voice belongs to |
provider_id |
str |
The voice's ID at the provider |
provider_model |
str |
The provider model the voice uses |
tags |
list |
The voice's tags |
parameters |
dict |
The voice's generation parameters |
is_scene_asset |
bool |
Whether the voice is stored as a scene asset |