Creative
Alphacreative_video_upscale
Upscale a public video in the connected workspace when its Creative flag is enabled.
Operation Write.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
body | object | Yes | Media settings. |
body.video_url | string | Yes | Public HTTPS video URL. Maximum 100 MB and 600 seconds. |
body.resolution | string | No | 1080p, 2K, or 4K. Default 1080p. |
body.enhancement_tier | string | No | fast, standard, or pro. Default fast. |
body.duration_seconds | number | No | Optional declared duration from 1 to 30 seconds. Billing uses the measured file duration. |
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. |
The quote rounds the measured source duration up to a whole second. Resolution, frame rate, and tier set the per-second rate. The output frame rate follows the measured input rate within 24 to 120 fps.
Pass data.job.id to creative_jobs_wait, then read the saved output with creative_jobs_result.
Sample prompt
Upscale my imported product video to 2K with standard enhancement and give me the finished video.