Creative
Alpha

creative_video_trim

Trim a saved video in the connected workspace when its Creative flag is enabled.

Operation Write.

Parameters

ParameterTypeRequiredDescription
bodyobjectYesVideo program.
body.video_urlstringYesURL of a video saved in this workspace. Maximum 100 MB.
body.startnumberYesStart in seconds from the beginning.
body.endnumberNoEnd in seconds. Supply exactly one of end and duration.
body.durationnumberNoLength in seconds, from 0.2 to 900.
body.precisionstringNoUse exact for re-encoding or keyframe for stream copy.
body.audiostringNoKeep or drop the audio track. Default keep.
body.outputobjectNoOptional width, height, and fps with exact precision.
body.modestringNoUse async to get a job ID immediately, sync or subscribe for a bounded wait, or webhook for terminal delivery.
body.wait_timeout_secondsintegerNoWait from 0 to 30 seconds in sync or subscribe mode.
body.webhook_urlstringNoPublic HTTPS URL for terminal delivery.
body.project_idstringNoDestination project in the same workspace.
body.metadataobjectNoCaller data to keep with the job.
idempotency_keystringYesReuse this key to retry the same request.

The source can be up to 1,800 seconds and the cut up to 900 seconds. Exact mode re-encodes the cut. Keyframe mode can start at an earlier keyframe.

Pass data.job.id to creative_jobs_wait, then read the saved output with creative_jobs_result.

Sample prompt

Trim seconds 2 to 7 from my imported product video, keep its audio, and give me the new MP4.