Video Status Node icon

Video Status Node

Get the status of a talking avatar video generation task.

Overview

This node retrieves the status of a talking avatar video generation task by querying an external API. It is useful in workflows where you need to monitor or check the progress and result of video generation tasks initiated elsewhere, enabling automation based on the video's readiness or failure.

For example, after submitting a video generation request to a service, this node can be used to periodically check if the video is ready for download or if it encountered any errors during processing.

Properties

Name Meaning
Task_Id The unique identifier of the talking avatar video generation task whose status is queried

Output

The node outputs JSON data representing the full response from the API endpoint that provides the status of the specified video generation task. This typically includes fields indicating the current state of the task (e.g., pending, processing, completed, failed) and may contain additional metadata about the video generation process.

No binary data output is produced by this node.

Dependencies

  • Requires an API token credential to authenticate requests.
  • Needs the API domain URL configured as part of the credentials.
  • Makes HTTP GET requests to the endpoint /video/async_generate_talking_avatar/{task_id}/status on the configured API domain.

Troubleshooting

  • Common issues:

    • Invalid or expired API token will cause authentication failures.
    • Incorrect or missing Task_Id will result in errors or empty responses.
    • Network connectivity problems can cause request timeouts or failures.
  • Error messages:

    • "Error generate a talking avatar video request: <message>" indicates a failure when calling the API. Check the API token validity, network connection, and correctness of the task ID.
    • If the node is set to continue on fail, errors are returned in the output JSON under an error field instead of stopping execution.

Links and References

  • Refer to the external API documentation for details on the /video/async_generate_talking_avatar/{task_id}/status endpoint and its response schema.
  • n8n documentation on creating and using credentials for API authentication.

Discussion