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 current state of those tasks.
For example, after starting a video generation process in a previous step, this node can be used to poll the status until the video is ready, failed, or still 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 response from the external API about the video generation task status. This typically includes fields indicating whether the task is completed, in progress, failed, or other relevant metadata returned by the API.
If an error occurs during the request, the output JSON will contain an error field with the error message.
Dependencies
- Requires an API token credential for authentication.
- Needs the API domain URL configured in the credentials.
- Makes HTTP GET requests to the endpoint
/video/async_generate_talking_avatar/{task_id}/status.
Troubleshooting
- Common issues:
- Invalid or expired API token causing authentication failures.
- Incorrect or missing task ID leading to 404 or similar errors.
- Network connectivity problems preventing API calls.
- Error messages:
"Error generate a talking avatar video request: <message>"indicates a failure in the HTTP request; verify API token validity, task ID correctness, and network access.
- To handle errors gracefully, enable "Continue On Fail" to receive error details in the output instead of stopping execution.
Links and References
- Refer to the external API documentation for the talking avatar video service for detailed information on the status response structure and possible states.