Discussions

Hi HeyGen Team,

I hope you're doing well. I had a question regarding the API behavior for avatar generation.

On the HeyGen web platform, I can explicitly choose between Avatar IV (the higher-quality model) and Avatar Unlimited (the standard model) for the same avatar. However, in the API documentation, it seems there’s no direct parameter to toggle between these model types — only the ability to choose an avatar ID.

Could you please clarify:

How can I specify whether I want to generate a video using the Avatar IV model or the standard model through the API?

Is this determined by which endpoint I use (e.g., /v2/video/av4/generate vs /v2/video/generate), or is there a hidden parameter or avatar property that controls the model quality? The Avatar IV endpoint in the API is for photo generation only though. I want to get generation from my avatar.

If I already have a talking photo or avatar created on the platform, how can I programmatically ensure the API uses the Avatar IV version of it?

Thank you for your help — I just want to make sure I’m calling the right endpoint for high-quality Avatar IV output. (I have scale API)

Best regards,
Sibte