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):
{
"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, E_INVALID_TIME, E_NOT_FOUND, E_TYPE_MISMATCH, E_ID_EXISTS, E_LIMIT, E_OUT_OF_SOURCE, E_OVERLAP
Scope and phase#
Scope edit, phase prototype. Run vukem-video command:help clip.add for the same description from the binary.