Creative
Alphacreative_timeline_render
Creative フラグが有効な接続先ワークスペースで、保存済み素材からタイムラインをレンダーします。
Operation Write.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
body | object | Yes | Timeline settings. |
body.audio | object | Yes | Set duration_seconds from 1 to 1800 and choose a saved url, ordered parts, or mode: silence. |
body.video | array | Yes | Provide 1–200 ordered clips or stills. Each needs a source_url, start, and duration. Optional fields include source_in, fit, and the incoming transition. |
body.soundtrack | object | No | Provide a saved audio url with optional gain, looping, fade-out, or ducking under the spine. |
body.output | object | No | Set output geometry, frame rate, and intro or outro fades. The output format is MP4. |
body.render | object | No | Set the render strategy, chunk_max_segments, and short-source pad_mode. |
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. |
先頭の映像区間は 0 秒から始めます。後続の区間は音声軸上の開始時刻を指定します。切り替えは後続の区間の開始時刻から始まります。出力は最大 1,800 秒で、申告した長さを分単位で切り上げて料金を予約します。
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 を作ってください。デモへの切り替えは 0.25 秒のフェードにして、完了まで待ってください。