Discussions

Ask a Question
Back to all

API Caption Styling - Documentation gap

I’m using POST /v2/video/generate to create talking-head videos from script input, and I can see caption: true in the docs.

What I cannot find is any clear, working documentation for caption/subtitle customisation via API. I found references suggesting this exists, for example preset styles / text object / font size / position / alignment, but I cannot find a proper request schema or a full payload example.

Can HeyGen please clarify:

  • Is caption styling currently supported via POST /v2/video/generate?
    If yes, what is the exact request body structure?
  • What subtitle style options are available, for example preset names, font controls, position, alignment, colours, background, per-word highlighting, etc?
  • Can you share a full working example payload for a script-based talking-head video with styled subtitles enabled?

A concrete example would help a lot, because right now the public docs seem to clearly show caption: true, but not the actual subtitle customisation implementation.