Creative
Alpha

creative_timeline_compose

Creative フラグが有効な接続先ワークスペースで、保存済みの静止画と動画を 1 画面に合成します。

Operation Write.

Parameters

ParameterTypeRequiredDescription
bodyobjectYesTimeline settings.
body.operationstringYesUse stack for two regions or overlay to place the still over the video.
body.imageobjectYesProvide the saved still image url.
body.videoobjectYesProvide the saved video url and optional source_in and duration in seconds.
body.layoutobjectNoStack accepts split, image_region, ratio, image_fit, and video_fit. Overlay accepts position, width_ratio, margin_ratio, and video_fit.
body.outputobjectNoSet even width and height from 256 to 2160 and optional fps (24, 25, 30, or 60).
body.modestringNoUse async for an immediate job ID, 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.

出力の長さは動画で決まり、最大 300 秒です。動画に音声があれば MP4 に残ります。出力設定を省略すると、1080 × 1920 と元動画のフレームレートを使います。

Use media saved in the connected workspace. Inputs and outputs each have a combined limit of 400 MB. Pass data.job.id to creative_jobs_wait, then retrieve the output with creative_jobs_result.

Sample prompt

保存した商品画像を上半分に、音声付きのデモ動画を下半分に配置して、縦長の MP4 を作ってください。