Actions20
Overview
This node integrates with the Tavus API to manage and interact with AI-driven video generation resources. Specifically, for the Speech - List operation, it retrieves a paginated list of speeches associated with replicas (digital avatars/models). This is useful when you want to fetch existing speech data generated or stored in the Tavus platform, for example, to review available speeches, display them in a UI, or process them further in an automation workflow.
Practical scenarios include:
- Listing all speeches created for a specific replica to monitor or audit content.
- Fetching speeches page by page to display in dashboards or reports.
- Filtering speeches by replica ID to focus on speeches related to a particular digital avatar.
Properties
| Name | Meaning |
|---|---|
| Limit | The number of speeches to return per page. Must be between 1 and 100. Default is 10. |
| Page | The page number to return, starting from 1. Default is 1. |
| Replica ID | Optional filter: a unique identifier for the replica whose speeches you want to list. |
Output
The output is a JSON array where each item represents a speech object retrieved from the Tavus API. Each speech object contains details about a speech such as its ID, associated replica, script, creation date, and other metadata provided by the API.
The node does not output binary data for this operation; it only returns structured JSON data representing speeches.
Dependencies
- Requires an active connection to the Tavus API using an API key credential configured in n8n.
- The node uses internal helper functions to make authenticated HTTP requests to the Tavus REST endpoints.
- No additional external dependencies are required beyond the configured API credentials.
Troubleshooting
- Invalid JSON in properties: If any JSON input fields (not applicable for this operation but relevant for others) are malformed, the node will throw an error indicating invalid JSON.
- API request failures: Errors from the Tavus API (e.g., authentication errors, rate limits, invalid parameters) will be surfaced as error messages. Ensure your API key is valid and has sufficient permissions.
- Empty results: If no speeches match the criteria (e.g., wrong replica ID), the node will return an empty array.
- Pagination issues: Make sure the
PageandLimitparameters are within allowed ranges to avoid unexpected empty responses.
Links and References
- Tavus API Documentation (for detailed API endpoint info)
- n8n documentation on Creating Custom Nodes
- General REST API usage in n8n workflows
If you need summaries for other operations or resources, feel free to ask!