Summary
The direct video generation endpoints (/v2/video/generate, /v3/videos) and the create_video_from_avatar flow only support caption: { style: "default" }. The default burns captions in small and low (over the subject) — practically unusable for vertical short-form video.
HeyGen support confirmed (ticket): caption style / size / position / highlight color / font cannot be customized on the direct generation endpoints — only "default". The styled captions available in Studio (large, mid-frame, keyword-highlighted, Brand Kit caption presets) are not exposed via the direct API/CLI.
Request
Expose caption styling on the direct generation endpoints (and the CLI), e.g.:
- a
subtitles / caption object with font_size, position, alignment (as already exists on the Legacy Template API), and
- the ability to reference a Brand Kit caption preset by ID (
brand_kit_id exists on the Video Agent endpoint but not on direct generation).
Why
A fully programmatic pipeline (avatar + script → captioned short) currently has to either (a) accept tiny "default" captions, (b) maintain a Studio template per layout, or (c) post-process the sidecar SRT with custom rendering. Native styled captions on the direct API/CLI would remove that friction.
Workarounds today (per support)
- Legacy Template API
subtitles object (preset_name, alignment, font_size, position)
- SRT post-processing via the returned
subtitle_url
Summary
The direct video generation endpoints (
/v2/video/generate,/v3/videos) and thecreate_video_from_avatarflow only supportcaption: { style: "default" }. The default burns captions in small and low (over the subject) — practically unusable for vertical short-form video.HeyGen support confirmed (ticket): caption style / size / position / highlight color / font cannot be customized on the direct generation endpoints — only
"default". The styled captions available in Studio (large, mid-frame, keyword-highlighted, Brand Kit caption presets) are not exposed via the direct API/CLI.Request
Expose caption styling on the direct generation endpoints (and the CLI), e.g.:
subtitles/captionobject withfont_size,position,alignment(as already exists on the Legacy Template API), andbrand_kit_idexists on the Video Agent endpoint but not on direct generation).Why
A fully programmatic pipeline (avatar + script → captioned short) currently has to either (a) accept tiny
"default"captions, (b) maintain a Studio template per layout, or (c) post-process the sidecar SRT with custom rendering. Native styled captions on the direct API/CLI would remove that friction.Workarounds today (per support)
subtitlesobject (preset_name,alignment,font_size,position)subtitle_url