Spec · Embedded Captions · heygen-com/hyperframes · Skills Docs

Spec · Embedded Captions · heygen-com/hyperframes · Skills Docs

Field	What	Example (1920×1080)
`plane.top/left/width/height`	Where the side column sits. Pick the side opposite the subject’s gaze (looking room) and hug the cleanest backdrop zone.	`{top: 40, left: 40, width: 720, height: 420}`
`plane.rotateY`	Slight perspective into the wall. Positive for left column (recedes right), negative for right column. Keep small (3-7°).	`4`
`crown_top`	Y position of the crown. Should fall on the subject’s chest/neck so the body occludes the middle letters.	`420`
`font_scale`	Multiplier on locked sizes.	`1.0` for 1920×1080
`crown_enabled`	Whether to render a crown. Skip if the speech has no clean payoff line, or if the subject is too far off-center for a center crown to land.	`true`

Slot	Use for
intro	Filler / discourse markers (“you know,”, “for me,”, “so…”)
phrase	Main statement clauses
emph	Key achievement / superlative line
dream	Aspirational lines, past-tense reflection
crown	The single climax line — center-stage payoff

{
  "mode": "template",
  "template": "champion",
  "duration": 12.08, "fps": 24, "width": 1920, "height": 1080,
  "plane": {
    "top": 40, "left": 40, "width": 720, "height": 420,
    "rotateY": 4
  },
  "crown_top": 420,
  "font_scale": 1.0,
  "groups": [
    { "id": "cg-0", "slot": "intro", "tone": "soft",
      "in": 0.10, "out": 1.45, "words": [...] },
    { "id": "cg-1", "slot": "phrase", "tone": "soft",
      "in": 1.55, "out": 4.20, "words": [...] },
    { "id": "cg-2", "slot": "emph", "tone": "present",
      "in": 6.50, "out": 8.30, "words": [...] }
  ],
  "crown_group": {
    "id": "cg-crown", "tone": "present",
    "in": 10.85, "out": 12.08,
    "words": [
      {"text": "Wimbledon", "start": 10.94, "end": 11.28},
      {"text": "Champion",  "start": 11.38, "end": 11.84}
    ]
  }
}