Overview
This node creates a talking avatar video generation task by sending a base64 encoded audio file and image to an external service. It supports asynchronous operation with webhook callbacks or synchronous polling until the video generation is complete. This node is useful for automating avatar video creation where an image "speaks" the provided audio, such as in marketing videos, virtual assistants, or personalized greetings.
Practical examples:
- Generate a talking avatar video from a user's photo and recorded message.
- Automate video content creation for social media using avatars.
- Create interactive chatbot responses with avatar videos.
Properties
| Name | Meaning |
|---|---|
| Audio | The base64 encoded audio file used as the avatar's speech. |
| Image | The base64 encoded image used as the avatar's face. |
| Synchronous | Whether to wait synchronously for the video generation to complete (true) or handle asynchronously (false). |
| Time Out (Second) | Maximum waiting time in seconds when running synchronously (between 2 and 600 seconds). |
| Webhook Options | Collection of options for async operation: - Auth Token: token to authenticate webhook requests via 'Authorization: Bearer' header. - Url: webhook URL to receive async task status updates. |
Output
The node outputs JSON data containing the response from the video generation API:
- In asynchronous mode (default), it returns the initial API response including the generated
task_id. - In synchronous mode, it polls the task status endpoint until the task completes or times out, then outputs the final status JSON which includes detailed task results.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating requests to the external video generation service.
- Needs the API domain URL configured in credentials.
- Uses HTTP requests to interact with the external service endpoints
/video/async_generate_talking_avatarand/video/async_generate_talking_avatar/{task_id}/status.
Troubleshooting
Common issues:
- Invalid or missing API key will cause authentication failures.
- Incorrect base64 encoding of audio or image data may result in server errors or invalid task creation.
- Timeout too short in synchronous mode might cause incomplete results.
- Webhook URL misconfiguration can lead to missed async status updates.
Error messages:
"Failed to get valid task_id from server.": The API did not return a valid task ID; check request payload and credentials."Error generate a talking avatar video request: ...": General request failure; inspect error details for network or API issues.
Resolutions:
- Verify API key and domain are correct and active.
- Ensure audio and image inputs are properly base64 encoded strings.
- Increase timeout if synchronous polling ends prematurely.
- Confirm webhook URL is reachable and correctly set up to receive POST requests with authorization if needed.
Links and References
- No direct links available in the source code. Consult your video generation service provider's API documentation for more details on endpoints and authentication.