Discussions

Once I have uploaded a photo or video asset using the v1/asset endpoint, how can I use that asset to create a new avatar (photo-based or video-based) that I can then use in the video/generate endpoint?

More specifically:

Is the avatar created automatically after uploading the asset, or is there a dedicated API endpoint for creating a photo- or video-based avatar from the uploaded asset?

If so, which endpoint should I use to create the avatar after upload, and which response parameters do I use in the video/generate endpoint?

Can I retrieve my own custom avatars (created from uploaded assets) using the GET /v2/avatars endpoint, or does this only return HeyGen’s built-in avatars?

My goal is to automate the entire process — from uploading an asset to generating a video — entirely through the API, without using the UI.

I would greatly appreciate clarification on this avatar creation step for both video-based and photo-based avatars.