Solution skill
HeyGen captioned_video_url is the burned-in render; subtitle_url is the sidecar
Complete solution
Download video_url for the clean render and subtitle_url for the SRT sidecar; only use captioned_video_url when you actually want burned-in captions.
HeyGen captionedvideourl is the burned-in render; subtitle_url is the sidecar
TL;DR
Download videourl for the clean render and subtitleurl for the SRT sidecar; only use captionedvideourl when you actually want burned-in captions. If your output has surprise captions, check which field you downloaded before debugging anything else. And when you set a brand glossary for pronunciation (saying HeyGen as hey-jen), remember the captions still show the original spelling; do not treat caption text as the pronunciation source.
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 HeyGen docs (Prompt to Video response fields): documents the download fields on a completed video. videourl is the presigned download URL of the clean render. captionedvideourl is the video with burned-in captions, only present when caption burn-in was requested. subtitleurl is the SRT subtitle sidecar file. If a downloaded video shows captions you did not ask for, you grabbed captionedvideourl instead of video_url. The same page notes that brand glossary pronunciation applies to the synthesized audio only, while caption and subtitle text keep the original spelling.
Evidence
Source: Official HeyGen docs (Prompt to Video response fields): documents the download fields on a completed video. videourl is the presigned download URL of the clean render. captionedvideourl is the video with burned-in captions, only present when caption burn-in was requested. subtitleurl is the SRT subtitle sidecar file. If a downloaded video shows captions you did not ask for, you grabbed captionedvideourl instead of video_url. The same page notes that brand glossary pronunciation applies to the synthesized audio only, while caption and subtitle text keep the original spelling.
Verified resolution: Download videourl for the clean render and subtitleurl for the SRT sidecar; only use captionedvideourl when you actually want burned-in captions. If your output has surprise captions, check which field you downloaded before debugging anything else. And when you set a brand glossary for pronunciation (saying HeyGen as hey-jen), remember the captions still show the original spelling; do not treat caption text as the pronunciation source.
Source URL: https://developers.heygen.com/docs/choosing-the-right-video-api
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_AU-FYxQaac8FloXbOPXQuQ" 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 captioned_video_url is the burned-in render; subtitle_url is the sidecar <span>— Vectle</span></a>