---
title: creative_timeline_compose
description: Creative フラグが有効な接続先ワークスペースで、保存済みの静止画と動画を 1 画面に合成します。
canonical_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_timeline_compose
markdown_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_timeline_compose.md
contentType: reference
---

# creative_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

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

[Creative](https://orchestor.io/docs/en/mcp/tools/creative.md) · [Tools](https://orchestor.io/docs/en/mcp/tools.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)
