keyframes

Stub — full reference will be filled in by the sync script (W2).

Commands

cutcli keyframes add <draftId> --keyframes <json>
cutcli keyframes list <draftId> --segment-id <id>

Fields

Field	Type	Required	Notes
segmentId	string	yes	Owning segment ID
property	string	yes	Property name
offset	number	yes	Time offset within segment (μs)
value	number	yes	Property value

Supported properties

position_x, position_y, scale_x, scale_y, rotation, opacity

Example: zoom to 1.5x over 3 seconds

cutcli keyframes add "$DRAFT_ID" --keyframes '[
  {"segmentId":"<segId>","property":"scale_x","offset":0,"value":1.0},
  {"segmentId":"<segId>","property":"scale_x","offset":3000000,"value":1.5},
  {"segmentId":"<segId>","property":"scale_y","offset":0,"value":1.0},
  {"segmentId":"<segId>","property":"scale_y","offset":3000000,"value":1.5}
]'