Tavus icon

Tavus

Work with Tavus API for AI-driven video generation

Actions20

Overview

This node integrates with the Tavus API to manage "replicas," which are AI-driven video avatars trained from videos. The Get Replica operation retrieves detailed information about a specific replica by its ID. This is useful when you want to fetch the current state, metadata, or additional details of a particular replica for further processing or decision-making in your workflow.

Practical examples:

  • Fetching a replica's details before generating a new video using that replica.
  • Retrieving verbose data about a replica to display or log its training status and properties.
  • Using replica information to conditionally branch workflows based on replica attributes.

Properties

Name Meaning
Replica ID The unique identifier of the replica to retrieve.
Verbose Boolean flag to include additional detailed data about the replica in the response.

Output

The node outputs JSON data representing the replica object retrieved from the Tavus API. This includes standard replica fields such as ID, name, model version, training status, and other metadata. If the Verbose option is enabled, the output will contain extended information about the replica, potentially including detailed training logs, configuration, or usage statistics.

No binary data is output by this operation.

Dependencies

  • Requires an active connection to the Tavus API via an API key credential configured in n8n.
  • The node uses HTTP requests to communicate with the Tavus API endpoints.
  • No additional environment variables are required beyond the API authentication setup.

Troubleshooting

  • Invalid Replica ID: If the provided Replica ID does not exist or is malformed, the API will return an error. Ensure the ID is correct and corresponds to an existing replica.
  • Authentication Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key credential is correctly set up in n8n.
  • JSON Parsing Errors: Although not typical for the Get operation, if any JSON input is malformed (in other operations), errors will be thrown. For this operation, ensure parameters are correctly typed.
  • Network Issues: Connectivity problems with the Tavus API endpoint can cause request failures. Check network access and API availability.

Links and References

Discussion