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
orc creative video generate --model seedance-2.5 --prompt "Slow push-in" --image-url https://example.com/start.png --wait --timeout 10m --jsonGenerate a video from a start image and wait up to 10 minutes.
Subcommands
models list
動画モデルを一覧表示
orc creative video models list [options]models get
動画モデルを取得
orc creative video models get <model-id> [options]generate
動画を生成
orc creative video generate [options]Unique options
--idempotency-key
同じ入力の再送で同じジョブを返すキー。1〜255 文字の印字可能 ASCII。同じキーで異なる入力を送ると 409 です。
Type: string. Optional.
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.
orc creative video generate --model <value>--prompt
生成する内容、または編集で変更したい内容を記述する文章。
Type: string. Optional.
orc creative video generate --prompt <value>--image-url
動画の最初のフレーム、または顔画像に使う公開 HTTPS URL。
Type: string. Optional.
orc creative video generate --image-url <value>--end-image-url
動画の最後のフレームの公開 HTTPS URL。image_url と組み合わせて指定します。
Type: string. Optional.
orc creative video generate --end-image-url <value>--video-url
編集・延長などの入力動画の公開 HTTPS URL。
Type: string. Optional.
orc creative video generate --video-url <value>--motion-video-url
モーション元の動画。motion control モデルのみ
Type: string. Optional.
orc creative video generate --motion-video-url <value>--character-orientation
video は動作参照動画、image は静止画の構図を優先します。; enum: image|video
Type: string. Optional.
orc creative video generate --character-orientation <value>--keep-original-sound
true では動作参照動画の音声を残し、false では無音にします。
Type: string. Optional.
orc creative video generate --keep-original-sound <value>--reference-images
参照画像を URL または種類付きのオブジェクトで指定します。モデルごとの上限は capabilities を確認してください。; csv
Type: string. Optional.
orc creative video generate --reference-images <value>--reference-videos
参照動画を URL または種類付きのオブジェクトで指定します。モデルごとの上限は capabilities を確認してください。; csv
Type: string. Optional.
orc creative video generate --reference-videos <value>--reference-audio
参照音声を URL または種類付きのオブジェクトで指定します。モデルごとの上限と合計上限は capabilities を確認してください。; csv
Type: string. Optional.
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.
orc creative video generate --resolution <value>--duration-seconds
生成する動画の長さを秒で指定します。共通範囲は 1〜600 秒で、モデルごとの範囲も適用されます。
Type: number. Optional.
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.
orc creative video generate --aspect-ratio <value>--generate-audio
対応するモデルで動画と同時に音声を生成するかどうか。
Type: string. Optional.
orc creative video generate --generate-audio <value>--metadata
利用者の追跡用データ。ジョブと関連付けて保存し、モデルには送りません。; (JSON object, e.g. '{"custom_id":"x"}')
Type: string. Optional.
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.
orc creative video generate --mode <value>--webhook-url
終端イベントを受け取る公開 HTTPS URL(2048 文字以内、既定のポート)。async または webhook モードで指定し、sync とは併用できません。localhost、プライベート、ループバック、リンクローカルのアドレス宛ては指定できません。ジョブが完了、失敗、取消のいずれかになると、ワークスペースの署名シークレットで署名した通知を 1 件送ります。; max 2048 chars
Type: string. Optional.
orc creative video generate --webhook-url <value>--wait-timeout-seconds
HTTP 応答を待つ秒数。0〜30。時間を過ぎてもジョブは継続します。
Type: number. Optional.
orc creative video generate --wait-timeout-seconds <value>--project-id
ジョブまたは配置先を関連付けるプロジェクトの ID。; max 200 chars
Type: string. Optional.
orc creative video generate --project-id <value>--seed
再現性の調整に使う乱数シード。0〜4,294,967,295。
Type: number. Optional.
orc creative video generate --seed <value>--task
auto- の自動モデル選択に渡す制作意図。名前を指定したモデルでは使用しません。
Type: string. Optional.
orc creative video generate --task <value>--audio-url
リップシンク用の音声の公開 HTTPS URL。顔画像には image_url、顔動画には video_url を使い、duration も指定します。
Type: string. Optional.
orc creative video generate --audio-url <value>--model-params
モデル固有設定の予約領域。現在は省略するか空オブジェクトを指定します。追加のキーは受け付けません。; (JSON object, e.g. '{"custom_id":"x"}')
Type: string. Optional.
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.
orc creative video generate --prompt-enhancement <value>--end-user-id
heygen-video-1 に渡す利用者の不透明な ID。1〜128 文字、空白と個人情報を含めません。; max 128 chars
Type: string. Optional.
orc creative video generate --end-user-id <value>--callback-id
heygen-video-1 の追跡用 ID。最大 256 文字で metadata.callback_id に保存し、通知にも含めます。; max 256 chars
Type: string. Optional.
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.
orc creative video generate --draft <value>--draft-job-id
seedance-2.5 の完了済み下書きの ID。model と、この ID と任意の resolution: 1080p だけを送り、元の入力を引き継ぎます。作成後 14 日以内に使用します。
Type: string. Optional.
orc creative video generate --draft-job-id <value>--extend
seedance-2.5 で video_url の続きを生成します。duration は追加部分の 4〜30 秒です。
Type: string. Optional.
orc creative video generate --extend <value>--source-duration
延長する元動画の秒数を切り上げた整数。1〜30。seedance-2.5 の extend で使用し、省略時は 15 秒として料金を計算します。
Type: number. Optional.
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.
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.
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.
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.
orc creative video generate --background <value>--depth
対応モデルの動画深度マップの描画設定。元動画の秒数を切り上げた duration と video_url を指定します。; (JSON object, e.g. '{"custom_id":"x"}')
Type: string. Optional.
orc creative video generate --depth <value>--bitrate-mode
出力のビットレート設定。standard または high を対応モデルで使用します。; enum: standard|high
Type: string. Optional.
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.
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.
orc creative video generate --input-references <value>Examples
List the available video models.
orc creative video models list --jsonList the available video models.
Check one model's inputs.
orc creative video models get seedance-2.5 --jsonCheck one model's inputs.
Receive completion by webhook.
orc creative video generate --model seedance-2.5 --prompt "A beach at sunset" --webhook-url https://example.com/hooks/creativeReceive 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.