# clip.add

> Places a video or image asset on a visual track.

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

Adds a clip. The default duration is the rest of the asset from source_in, or 5 seconds for an image. The reserved asset ast_placeholder creates a template slot holder and needs an explicit duration.

## Arguments

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `asset_id` | `string` | yes | A video or image asset, or ast_placeholder in a template. |
| `duration` | `string` | no | A length; default the rest of the asset, or 5s for an image. |
| `fit` | `cover`, `contain`, `none` | no |  |
| `id` | `string` | no |  |
| `source_in` | `string` | no | Offset into the asset; default 0s; omit for an image. |
| `start` | `string` | yes | Absolute position. |
| `track_id` | `string` | yes | A visual track. |

## 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.add",
  "args": {
    "asset_id": "ast_3c5v8n2w6d",
    "duration": "5s",
    "id": "itm_m1n2p3q4r5",
    "source_in": "2s",
    "start": "0s",
    "track_id": "trk_f6g7h8j9k0"
  }
}
```

## Errors

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

## Scope and phase

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