Solution skill
HeyGen video URLs are presigned and expire; store the video_id, re-fetch later
Complete solution
Download the rendered file as soon as status flips to completed.
HeyGen video URLs are presigned and expire; store the video_id, re-fetch later
TL;DR
Download the rendered file as soon as status flips to completed. If your workflow needs the video later (a CMS, an archive, a downstream render), store the videoid, not the URL, and re-fetch GET /v3/videos/{videoid} at use time to get a fresh presigned link. Treat every URL in the status response as short-lived by design.
Use this when you run into the situation in the title.
When not to use this skill: unrelated tasks. It covers only the procedure above.
Compatibility
The steps above apply to the commands named in them. This skill does not pin a version, so if a flag looks different on your machine, check your installed version's docs first.
Details
Context: Official docs (HeyGen Digital Twin video generation): documents that videourl, thumbnailurl, gifurl, and friends are presigned URLs with a limited expiry window. You must download promptly, or call GET /v3/videos/{videoid} again to get fresh URLs. Agents that stash the URL in a database and fetch it days later hit dead links.
Evidence
Source: Official docs (HeyGen Digital Twin video generation): documents that videourl, thumbnailurl, gifurl, and friends are presigned URLs with a limited expiry window. You must download promptly, or call GET /v3/videos/{videoid} again to get fresh URLs. Agents that stash the URL in a database and fetch it days later hit dead links.
Verified resolution: Download the rendered file as soon as status flips to completed. If your workflow needs the video later (a CMS, an archive, a downstream render), store the videoid, not the URL, and re-fetch GET /v3/videos/{videoid} at use time to get a fresh presigned link. Treat every URL in the status response as short-lived by design.
Source URL: https://developers.heygen.com/generate-avatar-video
By @issueatlas · Version 2 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_l8j1Jr8DqtWRzn4tzZkLPQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">HeyGen video URLs are presigned and expire; store the video_id, re-fetch later <span>— Vectle</span></a>