---
title: creative video
description: 動画モデルを確認し、動画生成ジョブを作成します。
canonical_url: https://orchestor.io/docs/cli/creative/video
markdown_url: https://orchestor.io/docs/cli/creative/video.md
contentType: reference
---

# creative video

`orc creative video` は、動画モデルの一覧と詳細を返し、動画生成ジョブを作成します。テキスト、開始画像と終了画像、参照動画から生成できます。動画の生成には数分かかることがあるため、`--wait` には `--timeout` を合わせて指定します。

モデルごとに使える入力（解像度、秒数、アスペクト比など）は `video models get <model-id>` の `capabilities` と `constraints` で確認します。

## 使い方

```bash title="terminal"
orc creative video generate --model seedance-2.5 --prompt "カメラがゆっくり寄る" --image-url https://example.com/start.png --wait --timeout 10m --json
```

*開始画像から動画を生成し、最大 10 分待ちます。*

## サブコマンド

### `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]
```

#### 固有のオプション

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

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

型: `string`。任意。

```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-

型: `string`。任意。

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

##### `--prompt`

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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

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

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

型: `string`。任意。

```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

型: `string`。任意。

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

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

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

型: `number`。任意。

```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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

##### `--metadata`

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

型: `string`。任意。

```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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

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

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

型: `number`。任意。

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

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

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

型: `string`。任意。

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

##### `--seed`

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

型: `number`。任意。

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

##### `--task`

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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

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

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

型: `string`。任意。

```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

型: `string`。任意。

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

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

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

型: `string`。任意。

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

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

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

型: `string`。任意。

```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 は併用できません。

型: `string`。任意。

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

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

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

型: `string`。任意。

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

##### `--extend`

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

型: `string`。任意。

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

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

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

型: `number`。任意。

```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"}')

型: `string`。任意。

```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"}')

型: `string`。任意。

```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"}')

型: `string`。任意。

```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"}')

型: `string`。任意。

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

##### `--depth`

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

型: `string`。任意。

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

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

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

型: `string`。任意。

```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)

型: `string`。任意。

```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)

型: `string`。任意。

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

## 使用例

### 利用できる動画モデルを一覧します。

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

*利用できる動画モデルを一覧します。*

### 1 つのモデルの対応入力を確認します。

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

*1 つのモデルの対応入力を確認します。*

### 完了を Webhook で受け取ります。

```bash title="terminal"
orc creative video generate --model seedance-2.5 --prompt "波打ち際の夕景" --webhook-url https://example.com/hooks/creative
```

*完了を Webhook で受け取ります。*

## 必要な権限

CLI の認証（`orc auth login` または `ORCHESTOR_API_KEY`）と、対象 Workspace へのアクセスが必要です。 ジョブの作成には書き込み権限が必要です。

## グローバルオプション

`orc creative video` では、次の[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を使用できます。

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%98%E3%83%AB%E3%83%97)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#%E5%87%BA%E5%8A%9B%E5%BD%A2%E5%BC%8F)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#%E5%80%A4%E3%81%A0%E3%81%91%E3%82%92%E5%87%BA%E5%8A%9B)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%B8%E3%81%AE%E5%87%BA%E5%8A%9B)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%9A%E3%83%BC%E3%82%B8%E9%80%81%E3%82%8A)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E4%BA%8B%E5%89%8D%E7%A2%BA%E8%AA%8D)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#%E7%A2%BA%E8%AA%8D%E3%81%AE%E7%9C%81%E7%95%A5)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#%E3%81%99%E3%81%B9%E3%81%A6%E3%81%AE%E3%83%9A%E3%83%BC%E3%82%B8%E3%82%92%E5%8F%96%E5%BE%97)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E6%99%82%E9%96%93)
- [`--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#%E8%AA%AD%E3%81%BF%E5%8F%96%E3%82%8A%E5%B0%82%E7%94%A8%E3%83%A2%E3%83%BC%E3%83%89)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#%E5%A4%96%E9%83%A8%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%AE%E7%9B%AE%E5%8D%B0%E4%BB%98%E3%81%91)

各オプションの詳細と使用例は、[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を参照してください。

---

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