clip

Create a clip (sub-segment) of a video asset as a new asset in a folder.

clip

Create a clip (sub-segment) of a video asset as a new asset in a folder.

Extract a sub-segment of a video into a new asset under output_folder_id.

Safety class: A · API type: any · Min version: —

📘
Confinement
Both asset_id and output_folder_id must be within your run-root anchor; the clip lands in output_folder_id.

Signatures

def clip(sdk, asset_id, output_folder_id, start_time_code, end_time_code, title):
    """Create a clip of asset_id between two SMPTE timecodes into output_folder_id."""
    return sdk.clip_asset(asset_id, start_time_code, end_time_code, title, output_folder_id)

export async function clip(sdk, assetId, outputFolderId, startTimeCode, endTimeCode, title) {
    // Extract a sub-segment of a video into a new asset under outputFolderId.
    return await sdk.clipAsset(assetId, startTimeCode, endTimeCode, title, outputFolderId);
}

Parameters

Parameter (Python)	Parameter (JS)	Type	Required	Notes
`sdk`	`sdk`	Nomad_SDK	yes
`asset_id`	`assetId`	str	yes	e.g. `<video-asset-uuid>`
`output_folder_id`	`outputFolderId`	str	yes	e.g. `<folder-uuid>`
`start_time_code`	`startTimeCode`	str	yes	e.g. `00:00:00;00`
`end_time_code`	`endTimeCode`	str	yes	e.g. `00:00:01;00`
`title`	`title`	str	yes	e.g. `clip-1`

Returns

dict | None — the clip job/asset response; confirm the new asset settles under output_folder_id.

Errors

401 unauthenticated
404 asset or folder not found
source must be a processed video