AiVOOV - Text to Speech icon

AiVOOV - Text to Speech

AiVOOV now offers a seamless text-to-speech service, enabling you to convert text into natural-sounding audio for various workflows and applications.

Overview

This node provides a text-to-speech service using the AiVOOV API. It converts input text into natural-sounding audio, supporting multiple languages and voice options. This is useful for automating audio content creation such as voiceovers, announcements, accessibility features, or any workflow requiring speech synthesis from text.

Typical use cases include:

  • Generating audio versions of articles or messages.
  • Creating voice prompts for IVR systems.
  • Producing spoken notifications or alerts.
  • Enhancing accessibility by converting text to speech in various languages.

Properties

Name Meaning
Language Select the language and locale for the speech output. A wide range of languages and regional variants are supported (e.g., English US, Spanish Spain, Arabic Gulf, etc.).
Select Voice Name or ID Choose a specific voice within the selected language. The list dynamically loads voices available for the chosen language. You can also specify a voice ID via expression.
Text The text string you want to convert into speech. This is required and supports multiline input.

Output

The node outputs JSON data with the following structure per item:

  • status (boolean): Indicates whether the text-to-speech conversion was successful.
  • message (string): Provides additional information or error messages from the API.
  • audio (string, present if status is true): URL pointing to the generated audio file containing the synthesized speech.

No binary data is directly output by the node; instead, the audio is provided as a URI link to the generated speech file.

Dependencies

  • Requires an API key credential for the AiVOOV service.
  • Makes HTTP requests to the AiVOOV API endpoints:
    • To fetch available voices for a selected language.
    • To submit text for speech synthesis and receive the audio URI.
  • The node expects the API key to be configured in n8n credentials securely.

Troubleshooting

  • No credentials returned!
    This error occurs if the API key credential is missing or not properly configured. Ensure that the AiVOOV API key is set up correctly in n8n credentials.

  • API request failures or invalid responses:
    Network issues, invalid API keys, or exceeding usage limits may cause errors. Check your API key validity, network connectivity, and AiVOOV account status.

  • Empty or invalid voice selection:
    If no voice is selected or the voice ID is invalid, the API may reject the request. Make sure to select a valid voice from the dropdown or provide a correct voice ID expression.

  • Text input issues:
    The text property is required. Empty or malformed text inputs will likely cause the API to fail. Provide valid text strings.

  • Continue on Fail behavior:
    If enabled, the node will continue processing other items even if one fails, attaching error details to the output for failed items.

Links and References

Discussion