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