Sets the speed, from 0.25x to 4x, and rescales the duration, the fades, the transitions and the keyframes by the same ratio. With ripple track the later items of the track follow the change in length. Captions linked to the clip are listed, not changed.
Arguments#
| Argument | Type | Required | Description |
|---|---|---|---|
item_id | string | yes | A clip of a video asset, or an audio item. |
ripple | none, track | no | none (default) or track: shift the later items of the track. |
speed | string or object | yes | "1.5x" (up to 3 decimals) or {"num": 3, "den": 2}; 1/4 to 4. |
Example#
As one operation of an edit batch (the edit tool of MCP, vukem-video edit --ops, or POST /api/v1/projects/{id}/edit):
{
"op": "clip.set_speed",
"args": {
"item_id": "itm_m1n2p3q4r5",
"ripple": "track",
"speed": "1.5x"
}
}Errors#
E_VALIDATION, E_NOT_FOUND, E_TYPE_MISMATCH, E_OUT_OF_SOURCE, E_INVALID_TIME, E_OVERLAP
Scope and phase#
Scope edit, phase alpha. Run vukem-video command:help clip.set_speed for the same description from the binary.