Creative
Alphacreative_timeline_compose
Creative フラグが有効な接続先ワークスペースで、保存済みの静止画と動画を 1 画面に合成します。
Operation Write.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
body | object | Yes | Timeline settings. |
body.operation | string | Yes | Use stack for two regions or overlay to place the still over the video. |
body.image | object | Yes | Provide the saved still image url. |
body.video | object | Yes | Provide the saved video url and optional source_in and duration in seconds. |
body.layout | object | No | Stack accepts split, image_region, ratio, image_fit, and video_fit. Overlay accepts position, width_ratio, margin_ratio, and video_fit. |
body.output | object | No | Set even width and height from 256 to 2160 and optional fps (24, 25, 30, or 60). |
body.mode | string | No | Use async for an immediate job ID, 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. |
出力の長さは動画で決まり、最大 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 を作ってください。