Actions20
Overview
This node integrates with the Tavus API to manage AI-driven video and speech generation resources. Specifically, for the Speech - Get operation, it retrieves detailed information about a specific speech by its unique identifier. This is useful when you want to fetch the status, metadata, or results of a previously created speech synthesis request.
Common scenarios include:
- Checking the progress or completion status of a speech generation.
- Retrieving speech details for further processing or logging.
- Integrating speech data into workflows that depend on generated audio content.
Example: After creating a speech synthesis job, use this operation to get the speech's URL or metadata once it's ready.
Properties
| Name | Meaning |
|---|---|
| Speech ID | A unique identifier for the speech to retrieve. |
Output
The output is a JSON object containing the details of the requested speech. This typically includes metadata such as the speech's ID, status, creation time, associated replica ID, script text, and possibly URLs to the generated audio or related assets.
If the speech includes binary data (e.g., audio files), it would be referenced via URLs or handled separately; the node itself returns JSON metadata describing the speech resource.
Dependencies
- Requires an API key credential for authenticating with the Tavus API.
- The node makes HTTP requests to the Tavus API endpoints.
- Proper network access to Tavus API endpoints is necessary.
- No additional environment variables are explicitly required beyond the API credential.
Troubleshooting
- Invalid Speech ID: If the provided Speech ID does not exist or is malformed, the API will likely return an error indicating the speech was not found. Verify the ID correctness.
- Authentication Errors: Missing or invalid API credentials will cause authentication failures. Ensure the API key credential is correctly configured in n8n.
- Network Issues: Connectivity problems can cause request failures. Check network access and proxy settings if applicable.
- JSON Parsing Errors: Although unlikely in this operation, ensure that any JSON inputs (if extended) are valid to avoid errors.
- API Rate Limits: Excessive requests may be throttled by the Tavus API. Implement retry logic or reduce request frequency if needed.
Links and References
- Tavus API Documentation (general reference for API endpoints and usage)
- n8n documentation on Creating Custom Nodes