Tavus icon

Tavus

Work with Tavus API for AI-driven video generation
Join our community

Actions20

Overview

This node integrates with the Tavus API to manage AI-driven video generation and related resources. Specifically, for the Lipsync - List operation, it retrieves a paginated list of lipsync video requests previously created or available in the system.

Common scenarios where this node is beneficial include:

  • Fetching an overview of all lipsync video jobs to monitor their status.
  • Retrieving lipsync videos in batches for further processing or reporting.
  • Integrating lipsync video data into automated workflows, such as notifying users when new lipsync videos are ready.

Practical example:

  • A user wants to display the latest 10 lipsync videos generated by their system on a dashboard. They can use this node to fetch the first page of lipsyncs with a limit of 10 items per request.

Properties

Name Meaning
Limit The number of lipsyncs to return per page. Default is 10. Minimum 1, maximum 100.
Page The page number to return. Default is 1. Minimum value is 1.

Output

The output JSON contains an array of lipsync objects representing individual lipsync video requests. Each object typically includes metadata about the lipsync video such as its ID, status, creation date, and possibly URLs or references to the generated video.

The node does not output binary data directly; it returns structured JSON data describing lipsync video entries.

Dependencies

  • Requires an API key credential for authenticating with the Tavus API.
  • The node makes HTTP requests to the Tavus API endpoints to perform operations.
  • No additional environment variables are explicitly required beyond the API authentication setup.

Troubleshooting

  • Invalid JSON errors: If any input property expects JSON (not applicable for this operation), ensure the JSON is valid.
  • API Authentication Errors: Ensure the provided API key credential is valid and has sufficient permissions.
  • Pagination issues: If requesting pages beyond the available range, the API may return empty results.
  • Limit out of bounds: The limit parameter must be between 1 and 100; values outside this range may cause errors.

Links and References

Discussion