# clip.set_speed

> Changes the speed of a clip or audio item while keeping the same source range.

Source: https://alexgalhardo.github.io/vukem-video/docs/reference/commands/clip.set_speed/

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`):

```json
{
  "op": "clip.set_speed",
  "args": {
    "item_id": "itm_m1n2p3q4r5",
    "ripple": "track",
    "speed": "1.5x"
  }
}
```

## Errors

[`E_VALIDATION`](/docs/reference/error-codes#e_validation), [`E_NOT_FOUND`](/docs/reference/error-codes#e_not_found), [`E_TYPE_MISMATCH`](/docs/reference/error-codes#e_type_mismatch), [`E_OUT_OF_SOURCE`](/docs/reference/error-codes#e_out_of_source), [`E_INVALID_TIME`](/docs/reference/error-codes#e_invalid_time), [`E_OVERLAP`](/docs/reference/error-codes#e_overlap)

## Scope and phase

Scope `edit`, phase `alpha`. Run `vukem-video command:help clip.set_speed` for the same description from the binary.
