CLI

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

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

動画モデルを一覧表示

terminal
orc creative video models list [options]

models get

動画モデルを取得

terminal
orc creative video models get <model-id> [options]

generate

動画を生成

terminal
orc creative video generate [options]

Unique options

--idempotency-key

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

Type: string. Optional.

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.

terminal
orc creative video generate --model <value>
--prompt

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

Type: string. Optional.

terminal
orc creative video generate --prompt <value>
--image-url

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

Type: string. Optional.

terminal
orc creative video generate --image-url <value>
--end-image-url

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

Type: string. Optional.

terminal
orc creative video generate --end-image-url <value>
--video-url

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

Type: string. Optional.

terminal
orc creative video generate --video-url <value>
--motion-video-url

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

Type: string. Optional.

terminal
orc creative video generate --motion-video-url <value>
--character-orientation

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

Type: string. Optional.

terminal
orc creative video generate --character-orientation <value>
--keep-original-sound

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

Type: string. Optional.

terminal
orc creative video generate --keep-original-sound <value>
--reference-images

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

Type: string. Optional.

terminal
orc creative video generate --reference-images <value>
--reference-videos

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

Type: string. Optional.

terminal
orc creative video generate --reference-videos <value>
--reference-audio

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

Type: string. Optional.

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.

terminal
orc creative video generate --resolution <value>
--duration-seconds

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

Type: number. Optional.

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.

terminal
orc creative video generate --aspect-ratio <value>
--generate-audio

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

Type: string. Optional.

terminal
orc creative video generate --generate-audio <value>
--metadata

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

Type: string. Optional.

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.

terminal
orc creative video generate --mode <value>
--webhook-url

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

Type: string. Optional.

terminal
orc creative video generate --webhook-url <value>
--wait-timeout-seconds

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

Type: number. Optional.

terminal
orc creative video generate --wait-timeout-seconds <value>
--project-id

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

Type: string. Optional.

terminal
orc creative video generate --project-id <value>
--seed

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

Type: number. Optional.

terminal
orc creative video generate --seed <value>
--task

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

Type: string. Optional.

terminal
orc creative video generate --task <value>
--audio-url

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

Type: string. Optional.

terminal
orc creative video generate --audio-url <value>
--model-params

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

Type: string. Optional.

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.

terminal
orc creative video generate --prompt-enhancement <value>
--end-user-id

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

Type: string. Optional.

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.

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.

terminal
orc creative video generate --draft <value>
--draft-job-id

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

Type: string. Optional.

terminal
orc creative video generate --draft-job-id <value>
--extend

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

Type: string. Optional.

terminal
orc creative video generate --extend <value>
--source-duration

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

Type: number. Optional.

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.

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.

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.

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.

terminal
orc creative video generate --background <value>
--depth

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

Type: string. Optional.

terminal
orc creative video generate --depth <value>
--bitrate-mode

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

Type: string. Optional.

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.

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.

terminal
orc creative video generate --input-references <value>

Examples

List the available video models.

terminal
orc creative video models list --json

List the available video models.

Check one model's inputs.

terminal
orc creative video models get seedance-2.5 --json

Check one model's inputs.

Receive completion by webhook.

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 can be used with orc creative video:

For details and examples, see global options.