Creative
Alphacreative_video_filter
Apply pixel filters to a saved video in the connected workspace when its Creative flag is enabled.
Operation Write.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
body | object | Yes | Video program. |
body.video_url | string | Yes | URL of a video saved in this workspace. Maximum 100 MB. |
body.ops | array | No | Up to eight dim or crop operations, applied in order. |
body.filtergraph | string | No | An allowlisted pixel filtergraph. Supply ops, filtergraph, or both. |
body.mode | string | No | Use async to get a job ID immediately, sync or subscribe for a bounded wait, or webhook for terminal delivery. |
body.wait_timeout_seconds | integer | No | Wait from 0 to 30 seconds in sync or subscribe mode. |
body.webhook_url | string | No | Public HTTPS URL for terminal delivery. |
body.project_id | string | No | Destination project in the same workspace. |
body.metadata | object | No | Caller data to keep with the job. |
idempotency_key | string | Yes | Reuse 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.