---
title: creative video
description: List video models and create video generation jobs.
canonical_url: https://orchestor.io/docs/en/cli/creative/video
markdown_url: https://orchestor.io/docs/en/cli/creative/video.md
contentType: reference
---

# creative video

`orc creative video` lists video models, returns one model's details, and creates video generation jobs from text, start and end images, or reference videos. Video generation can take minutes, so pair `--wait` with `--timeout`.

Check which inputs a model accepts (resolution, duration, aspect ratio and more) in the `capabilities` and `constraints` of `video models get <model-id>`.

## Usage

```bash title="terminal"
orc creative video generate --model seedance-2.5 --prompt "Slow push-in" --image-url https://example.com/start.png --wait --timeout 10m --json
```

*Generate a video from a start image and wait up to 10 minutes.*

## Subcommands

### `models list`

動画モデルを一覧表示

```bash title="terminal"
orc creative video models list [options]
```

### `models get`

動画モデルを取得

```bash title="terminal"
orc creative video models get <model-id> [options]
```

### `generate`

動画を生成

```bash title="terminal"
orc creative video generate [options]
```

#### Unique options

##### `--idempotency-key`

同じ入力の再送で同じジョブを返すキー。1〜255 文字の印字可能 ASCII。同じキーで異なる入力を送ると 409 です。

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --idempotency-key <value>
```

##### `--model`

(required) カタログのモデル ID、または auto- を指定します。auto- は入力に応じてモデルを選ぶため、カタログの個別モデル行には含まれません。; enum: higgsfield-genjutsu|higgsfield-genjutsu-object-swap|higgsfield-genjutsu-light|higgsfield-genjutsu-light-object-swap|seedance-2.5|seedance-2-mini|seedance-2|seedance-2-fast|kling-3|wan-3.0|grok-imagine-video-1.5|minimax-h3|minimax-h3-max|minimax-h3-lite|minimax-h3-highspeed|wan-2.5-fast|gemini-omni-flash-1-2-extend|gemini-omni-flash-1.1|gemini-omni-flash-1.2|vidu-q4|vidu-q4-reference|veo-3.1|veo-3.1-fast|veo-3.1-lite|kling-4|kling-4-omni|kling-o1-video|flux-3-video-edit|minimax-02-fast|minimax-02|kling-3-omni-edit|kling-o1-video-edit|wan-2.2|wan-2.2-fast|grok-video-edit|kling-4-0-flash|flux-3-video|kling-2.5-turbo|wan-2.7|wan-2.6|wan-2.5|seedance-pro|seedance-pro-fast|grok-imagine-video|grok-imagine-video-1.5-lite|kling-motion-control|kling-3-motion-control|gemini-omni-flash-1-2-edit|seedance-2.5-edit|vidu-q3-pro|vidu-q3-turbo|vidu-q3|vidu-q3-mix|pixverse-c1|pixverse-v6|wand-vega-1.0-lite|wand-vega-1.0-pro|wand-vega-1.5-pro|mingmou-1|hailuo-h3-regen|heygen-video-1|kling-2.6|kling-3-turbo|kling-3-omni|hailuo-2.3|hailuo-2.3-fast|happy-horse-1.0|happy-horse-1.1|wan-3.0-prime|higgsfield-cinema-studio-4|veed-fabric-1.0|kling-avatar-2.0-pro|kling-avatar-2.0|omnihuman-1.5|omnihuman-2|wan-2.2-speech-to-video|sync-lipsync-3|sync-lipsync-2-pro|sync-lipsync-2|kling-lipsync|latentsync|veed-lipsync|pixverse-lipsync|veed-subtitles|veed-dubbing|topaz-video|sam-3.1-video|luma-ray-3.2-reframe|orchestor/depth-anything-video|orchestor/depth-anything-v3-video|orchestor/wand|auto-

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --model <value>
```

##### `--prompt`

生成する内容、または編集で変更したい内容を記述する文章。

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --prompt <value>
```

##### `--image-url`

動画の最初のフレーム、または顔画像に使う公開 HTTPS URL。

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --image-url <value>
```

##### `--end-image-url`

動画の最後のフレームの公開 HTTPS URL。image_url と組み合わせて指定します。

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --end-image-url <value>
```

##### `--video-url`

編集・延長などの入力動画の公開 HTTPS URL。

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --video-url <value>
```

##### `--motion-video-url`

モーション元の動画。motion control モデルのみ

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --motion-video-url <value>
```

##### `--character-orientation`

video は動作参照動画、image は静止画の構図を優先します。; enum: image|video

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --character-orientation <value>
```

##### `--keep-original-sound`

true では動作参照動画の音声を残し、false では無音にします。

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --keep-original-sound <value>
```

##### `--reference-images`

参照画像を URL または種類付きのオブジェクトで指定します。モデルごとの上限は capabilities を確認してください。; csv

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --reference-images <value>
```

##### `--reference-videos`

参照動画を URL または種類付きのオブジェクトで指定します。モデルごとの上限は capabilities を確認してください。; csv

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --reference-videos <value>
```

##### `--reference-audio`

参照音声を URL または種類付きのオブジェクトで指定します。モデルごとの上限と合計上限は capabilities を確認してください。; csv

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --reference-audio <value>
```

##### `--resolution`

出力の解像度。モデルが対応する値をカタログで確認します。; enum: 360p|480p|540p|720p|768p|1080p|2K|2k|4K|4k|8K|hd|fhd

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --resolution <value>
```

##### `--duration-seconds`

生成する動画の長さを秒で指定します。共通範囲は 1〜600 秒で、モデルごとの範囲も適用されます。

Type: `number`. Optional.

```bash title="terminal"
orc creative video generate --duration-seconds <value>
```

##### `--aspect-ratio`

出力の幅と高さの比。auto は入力画像に合わせます。モデルの対応値を確認してください。; enum: auto|adaptive|21:9|2:1|16:9|4:3|1:1|3:4|9:16|3:2|2:3|9:21

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --aspect-ratio <value>
```

##### `--generate-audio`

対応するモデルで動画と同時に音声を生成するかどうか。

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --generate-audio <value>
```

##### `--metadata`

利用者の追跡用データ。ジョブと関連付けて保存し、モデルには送りません。; (JSON object, e.g. '{"custom_id":"x"}')

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --metadata <value>
```

##### `--mode`

async は即時応答、webhook は終端通知、sync と subscribe は時間を区切って完了を待ちます。; enum: async|sync|subscribe|webhook|text_to_video|image_to_video|reference_to_video|t2v|i2v|ref2va

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --mode <value>
```

##### `--webhook-url`

終端イベントを受け取る公開 HTTPS URL（2048 文字以内、既定のポート）。async または webhook モードで指定し、sync とは併用できません。localhost、プライベート、ループバック、リンクローカルのアドレス宛ては指定できません。ジョブが完了、失敗、取消のいずれかになると、ワークスペースの署名シークレットで署名した通知を 1 件送ります。; max 2048 chars

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --webhook-url <value>
```

##### `--wait-timeout-seconds`

HTTP 応答を待つ秒数。0〜30。時間を過ぎてもジョブは継続します。

Type: `number`. Optional.

```bash title="terminal"
orc creative video generate --wait-timeout-seconds <value>
```

##### `--project-id`

ジョブまたは配置先を関連付けるプロジェクトの ID。; max 200 chars

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --project-id <value>
```

##### `--seed`

再現性の調整に使う乱数シード。0〜4,294,967,295。

Type: `number`. Optional.

```bash title="terminal"
orc creative video generate --seed <value>
```

##### `--task`

auto- の自動モデル選択に渡す制作意図。名前を指定したモデルでは使用しません。

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --task <value>
```

##### `--audio-url`

リップシンク用の音声の公開 HTTPS URL。顔画像には image_url、顔動画には video_url を使い、duration も指定します。

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --audio-url <value>
```

##### `--model-params`

モデル固有設定の予約領域。現在は省略するか空オブジェクトを指定します。追加のキーは受け付けません。; (JSON object, e.g. '{"custom_id":"x"}')

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --model-params <value>
```

##### `--prompt-enhancement`

heygen-video-1 の文章補正。15 秒超では turbo、quality、default を使います。default は turbo と同じ指定です。; enum: turbo|quality|ultraquality|disabled|default

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --prompt-enhancement <value>
```

##### `--end-user-id`

heygen-video-1 に渡す利用者の不透明な ID。1〜128 文字、空白と個人情報を含めません。; max 128 chars

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --end-user-id <value>
```

##### `--callback-id`

heygen-video-1 の追跡用 ID。最大 256 文字で metadata.callback_id に保存し、通知にも含めます。; max 256 chars

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --callback-id <value>
```

##### `--draft`

seedance-2.5 で 480p の下書きを作成します。duration_seconds が必須で、video_url、extend、source_duration、draft_job_id は併用できません。

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --draft <value>
```

##### `--draft-job-id`

seedance-2.5 の完了済み下書きの ID。model と、この ID と任意の resolution: 1080p だけを送り、元の入力を引き継ぎます。作成後 14 日以内に使用します。

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --draft-job-id <value>
```

##### `--extend`

seedance-2.5 で video_url の続きを生成します。duration は追加部分の 4〜30 秒です。

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --extend <value>
```

##### `--source-duration`

延長する元動画の秒数を切り上げた整数。1〜30。seedance-2.5 の extend で使用し、省略時は 15 秒として料金を計算します。

Type: `number`. Optional.

```bash title="terminal"
orc creative video generate --source-duration <value>
```

##### `--dubbing`

veed-dubbing の翻訳吹替設定。video_url と 2〜600 秒の duration が必要で、prompt・resolution・aspect_ratio は指定しません。; (JSON object, e.g. '{"custom_id":"x"}')

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --dubbing <value>
```

##### `--captions`

veed-subtitles の字幕設定。video_url と 2〜600 秒の duration が必要です。課金対象は最低 60 秒、既定の resolution は 1080p です。; (JSON object, e.g. '{"custom_id":"x"}')

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --captions <value>
```

##### `--upscale`

topaz-video の拡大・補間設定。video_url と切り上げた 2〜60 秒の duration が必要です。30 fps 超、または fps の省略時は料金が 2 倍になります。; (JSON object, e.g. '{"custom_id":"x"}')

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --upscale <value>
```

##### `--background`

sam-3.1-video の背景除去設定。prompt で残す対象を示し、video_url と切り上げた 2〜60 秒の duration_seconds を指定します。; (JSON object, e.g. '{"custom_id":"x"}')

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --background <value>
```

##### `--depth`

対応モデルの動画深度マップの描画設定。元動画の秒数を切り上げた duration と video_url を指定します。; (JSON object, e.g. '{"custom_id":"x"}')

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --depth <value>
```

##### `--bitrate-mode`

出力のビットレート設定。standard または high を対応モデルで使用します。; enum: standard|high

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --bitrate-mode <value>
```

##### `--frame-images`

auto- で使用する開始・終了フレーム。最大 2 件で、image_url と併用できます。; JSON array of objects (use --stdin for large resources)

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --frame-images <value>
```

##### `--input-references`

auto- で使用する参照メディア。最大 20 件で、type と同じ種類の URL オブジェクトを指定します。; JSON array of objects (use --stdin for large resources)

Type: `string`. Optional.

```bash title="terminal"
orc creative video generate --input-references <value>
```

## Examples

### List the available video models.

```bash title="terminal"
orc creative video models list --json
```

*List the available video models.*

### Check one model's inputs.

```bash title="terminal"
orc creative video models get seedance-2.5 --json
```

*Check one model's inputs.*

### Receive completion by webhook.

```bash title="terminal"
orc creative video generate --model seedance-2.5 --prompt "A beach at sunset" --webhook-url https://example.com/hooks/creative
```

*Receive completion by webhook.*

## Permissions

Requires CLI authentication (`orc auth login` or `ORCHESTOR_API_KEY`) and access to the target Workspace. Creating a job requires write access.

## Global Options

The following [global options](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc creative video`:

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#help)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#all-pages)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing)
- [`--wait`](https://orchestor.io/docs/cli/global-flags.md)
- [`--timeout`](https://orchestor.io/docs/cli/global-flags.md)
- [`--poll-interval`](https://orchestor.io/docs/cli/global-flags.md)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#read-only-mode)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#untrusted-content-wrapping)

For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md).

---

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