Caption workflow

How to download HeyGen captions, SRT files, and captioned videos

A captioned MP4 and an SRT solve different delivery problems. Keep the clean master and editable subtitle file even when the publishing channel needs burned-in text.

Quick answer

Open the completed video’s share/download interface and choose the video or captions/SRT option available for that project. For bulk or API workflows, completed video records can expose captioned_video_url and subtitle_url. Download the standard master too, because burned-in captions cannot be removed or restyled later.

Choose the right caption asset

AssetWhat it isBest use
Standard MP4Video without burned-in caption stylingMaster editing and platforms that render captions
Captioned MP4Text permanently rendered into framesSound-off social viewing and fixed visual control
SRTPlain subtitle text with timecodesAccessibility upload, editing, translation
TranscriptText without reliable timingReview and repurposing, not caption delivery

Do not call a transcript an SRT unless it contains correctly ordered time ranges. A publishing platform needs those timecodes to display lines at the right moment.

Download from the HeyGen interface

  1. Open Projects and select the completed video.
  2. Open its share or download controls.
  3. Choose the standard video, captioned version, or captions/SRT option shown.
  4. Save the files together and rename them before they become ambiguous.

HeyGen’s current download help says the video interface can provide full-video, audio, and captions SRT downloads. Available formats can depend on the project and plan, so use the options displayed for that output.

Retrieve caption assets in bulk or through the API

The current List Videos response documents both captioned_video_url and subtitle_url fields. A robust process should test each field rather than assuming every completed video has every variant.

  1. Follow pagination through the complete video list.
  2. For every completed video, record which asset URLs are present.
  3. Download the standard master and the selected caption assets.
  4. Write local filenames and success/failure status into a manifest.
  5. Record unavailable variants as exceptions, not silent omissions.

Review words, timing, placement, and identity

  • Play the opening, middle, and closing captions with sound.
  • Check names, brands, acronyms, numbers, and URLs against the approved script.
  • Confirm lines do not cover faces, products, or platform interface controls.
  • Open the SRT in a text editor and verify sequential timecodes.
  • Confirm the SRT and video share the same base filename and language code.
  • Review every target language with a qualified speaker before paid distribution.

HeyGen notes that only stylized captions added in AI Studio currently appear in the final rendered video. Treat the rendered caption version and sidecar subtitle file as separate deliverables.

Use filenames that survive handoff

launch-demo_vid_abc123_en-US_master.mp4
launch-demo_vid_abc123_en-US_captioned.mp4
launch-demo_vid_abc123_en-US.srt

Include the stable video ID when duplicate titles are possible. Language/locale prevents translated captions from being attached to the wrong video later.

If a caption URL or download option is missing

For a complete asset archive, use the HeyGen backup workflow. For downloading many completed variants, see the bulk-download methods.

Sources