Actions20
Overview
This node integrates with the Tavus API to create and manage AI-driven video replicas. Specifically, the "Replica - Create" operation allows users to train a new replica by providing a training video URL and optional parameters such as consent video, callback URL for training completion notifications, replica name, model version, and additional JSON properties.
Common scenarios where this node is beneficial include:
- Creating personalized AI avatars or digital replicas from training videos.
- Automating the generation of AI-driven video content based on user-provided media.
- Integrating AI video replica creation into workflows that require asynchronous processing and notification via callbacks.
Example use case:
A marketing team wants to generate multiple AI replicas of a spokesperson using different training videos. They can automate the creation process by supplying direct URLs to training videos and optionally receive callbacks when training completes.
Properties
| Name | Meaning |
|---|---|
| Train Video URL | Direct link to the training video (required). |
| Consent Video URL | Direct link to the consent video (optional). |
| Callback URL | URL to receive a callback notification when training completes (optional). |
| Replica Name | A custom name for the replica being created (optional). |
| Model Name | Specifies the model version to use for training the replica (optional). |
| Properties | Additional properties in JSON format to customize the replica creation (optional). |
Output
The output is a JSON object representing the response from the Tavus API after creating the replica. This typically includes details about the newly created replica such as its ID, status, and any metadata returned by the API.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Tavus API.
- Requires an API authentication token configured in n8n credentials to authorize requests.
- The node uses internal helper functions to make HTTP requests to the Tavus API endpoints.
Troubleshooting
- Invalid JSON in Properties: If the "Properties" field contains invalid JSON, the node will throw an error stating "Properties must be valid JSON". Ensure the JSON syntax is correct before running.
- Missing Required Fields: The "Train Video URL" is mandatory. Omitting it will cause the request to fail.
- API Authentication Errors: Ensure the API key credential is correctly set up in n8n; otherwise, requests will be unauthorized.
- Callback URL Issues: If provided, ensure the callback URL is publicly accessible and correctly handles incoming webhook requests.
- Network or API Errors: General network issues or API downtime may cause failures. Check connectivity and Tavus service status.
Links and References
- Tavus API Documentation (for detailed API usage and parameters)
- n8n Documentation (for general node usage and credential setup)