Overview
This node integrates with the Coqui XTTS-v2 service to perform multilingual text-to-speech voice cloning. It allows users to input text and generate speech audio that mimics a specific speaker's voice, supporting multiple languages. This is useful for creating personalized voice messages, audiobooks, virtual assistants, or any application requiring custom synthetic voices.
Typical use cases include:
- Generating speech from text in different languages using a cloned voice.
- Creating voiceovers for videos or presentations with a consistent speaker style.
- Automating customer support responses with natural-sounding cloned voices.
Properties
| Name | Meaning |
|---|---|
| Text | The text string to be converted into speech. |
| Speaker | URL of the audio file representing the speaker's voice to clone. |
| Langauge | Language code for the speech output. Options: ar, cs, de, en, es, fr, hi, hu, it, ko, nl, pl, pt, ru, tr, zh |
| Cleaup Voice | Boolean flag indicating whether to clean up the voice output (true or false). |
Output
The node outputs JSON data containing the result of the text-to-speech conversion. The exact structure depends on the response from the Coqui API but generally includes synthesized audio data or metadata about the generated speech.
If an error occurs during the request, the output JSON will contain an error field with the error message.
Binary data (such as audio files) is not explicitly handled or output by this node based on the static analysis; the output is JSON-wrapped results from the API.
Dependencies
- Requires an API key credential for authentication with the Coqui XTTS-v2 service.
- The node makes HTTP POST requests to the configured domain endpoint
/coqui. - The user must configure the API domain and provide a valid API key credential in n8n credentials settings.
Troubleshooting
No credentials returned!
This error occurs if the required API key credential is missing or not configured properly. Ensure the API key credential is set up correctly in n8n.Request errors from the Coqui API
Network issues, invalid parameters, or server errors may cause request failures. The node can be configured to continue on failure or throw an error. Check the error message in the output JSON for details.Incorrect language codes or speaker URLs
Providing unsupported language codes or invalid speaker audio URLs may lead to unexpected results or errors. Verify inputs before execution.
Links and References
- Coqui TTS GitHub - Official repository for Coqui Text-to-Speech.
- n8n Documentation - For general guidance on setting up credentials and using HTTP request nodes.