# caption.retime_from_clip

> Retimes the captions linked to a clip after the clip was moved, trimmed or sped up.

Source: https://alexgalhardo.github.io/vukem-video/pt-br/docs/reference/commands/caption.retime_from_clip/

Maps the transcript words of the visible range to the timeline again and gives them to the linked captions in order, each taking as many words as it has. Edited texts are kept when the word count is unchanged. The transcript is supplied by the service in resolved.

## Arguments

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `clip_item_id` | `string` | yes | A clip of a video asset with audio. |
| `resolved` | `object` | no | Filled by the service from the transcript of the asset; never sent by a caller. |

## 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": "caption.retime_from_clip",
  "args": {
    "clip_item_id": "itm_m1n2p3q4r5"
  }
}
```

## 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_INVALID_STATE`](/docs/reference/error-codes#e_invalid_state), [`E_OVERLAP`](/docs/reference/error-codes#e_overlap)

## Scope and phase

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