Creative
Alpha

creative_video_filter

Apply pixel filters to 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.opsarrayNoUp to eight dim or crop operations, applied in order.
body.filtergraphstringNoAn allowlisted pixel filtergraph. Supply ops, filtergraph, or both.
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.

Check the program first with creative_video_filter_check. The source can be up to 300 seconds. The encoder applies ops in order, then the filtergraph, and saves a new MP4.

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

Sample prompt

Dim my imported clip to 60 percent brightness, wait for the edit, and return the new MP4.