Actions20
Overview
This node integrates with the Tavus API to create AI-generated speech content based on a specified replica and script. It is useful for scenarios where you want to generate synthetic speech from a virtual persona or avatar (called a "replica") using custom scripts. For example, you can automate personalized video messages, voiceovers, or interactive dialogues by generating speech dynamically.
The "Create Speech" operation specifically sends a request to generate a new speech instance using a chosen replica and a text script. Optionally, you can name the speech and provide a callback URL to receive notifications when the speech generation completes.
Properties
| Name | Meaning |
|---|---|
| Replica ID | The unique identifier of the replica (virtual persona) that will be used to generate the speech. This is required. |
| Script | The text script that the replica will speak in the generated speech. This is required. |
| Speech Name | An optional name to assign to the generated speech for easier identification. |
| Callback URL | An optional URL to receive a webhook callback when the speech generation is finished. |
Output
The node outputs JSON data representing the created speech object returned by the Tavus API. This typically includes details such as the speech's unique ID, status, associated replica, script, and possibly URLs to access the generated speech media once ready.
No binary data output is produced by this operation; all information is delivered as structured JSON.
Dependencies
- Requires an active connection to the Tavus API.
- Requires an API authentication credential configured in n8n to authorize requests to the Tavus service.
- The node uses HTTP requests to communicate with the Tavus endpoints.
Troubleshooting
- Invalid JSON in properties: If additional JSON fields are provided (not applicable here but common in other operations), ensure they are valid JSON strings to avoid parsing errors.
- Missing required parameters: Ensure that "Replica ID" and "Script" are provided; otherwise, the API call will fail.
- API authentication errors: Verify that the API key or token credential is correctly set up and has sufficient permissions.
- Callback URL issues: If using a callback URL, ensure it is publicly accessible and correctly handles incoming webhook requests.
- Network or API downtime: Temporary failures may occur if the Tavus API is unreachable; retry or check service status.
Links and References
- Tavus API Documentation (for detailed API usage and speech generation specifics)
- n8n documentation on Creating Custom Nodes