動画モデル
vidu-q3-pro
動画カタログのモデル ID は vidu-q3-pro です。モデル一覧から同じ種類のモデルを比較できます。
使用前に確認すること
下の入力表は router が扱う共通パラメータです。すべての設定をこのモデルへ同時に渡せるという意味ではありません。利用するワークスペースのカタログ行で対応入力・値・組み合わせを確認し、対応する設定だけを送信してください。
GET /v1/creative/video-router/models/{model_id} で一行を取得します。data.model.capabilities と data.model.constraints を確認してから、生成要求を組み立てます。
curl 'https://api.orchestor.io/v1/creative/video-router/models/vidu-q3-pro' \
-H "Authorization: Bearer $ORCHESTOR_API_KEY"生成の手順と結果の受け取り方は動画生成を参照してください。
入力パラメータ
| フィールド | 型 | 指定 | 意味 | 値と制約 |
|---|---|---|---|---|
model | string | 必須 | このページのモデルを選ぶ ID。他のモデル名や別名に置き換えず指定します。 | 固定値 "vidu-q3-pro" |
prompt | string | 任意 | 生成する内容、または編集で変更したい内容を記述する文章。 | minLength: 1 |
image_url | string | 任意 | 動画の最初のフレーム、または顔画像に使う公開 HTTPS URL。 | format: "uri" |
end_image_url | string | 任意 | 動画の最後のフレームの公開 HTTPS URL。image_url と組み合わせて指定します。 | format: "uri" |
video_url | string | 任意 | 編集・延長などの入力動画の公開 HTTPS URL。 | format: "uri" |
motion_video_url | string | 任意 | モーション元の動画。motion control モデルのみ | format: "uri" |
character_orientation | string | 任意 | video は動作参照動画、image は静止画の構図を優先します。 | "image", "video" |
keep_original_sound | boolean | 任意 | true では動作参照動画の音声を残し、false では無音にします。 | モデルの capabilities と constraints で確認 |
reference_images | (string / object)[] | 任意 | 参照画像を URL または種類付きのオブジェクトで指定します。モデルごとの上限は capabilities を確認してください。 | maxItems: 30 |
reference_images[].type | string | 必須 | 参照入力の渡し方。URL、アセット ID、Base64 を区別します。 | "url", "asset_id", "base64" |
reference_images[].url | string | 任意 | 参照メディアを取得できる URL。URL 形式で渡す場合に使用します。 | maxLength: 2048; format: "uri" |
reference_videos | (string / object)[] | 任意 | 参照動画を URL または種類付きのオブジェクトで指定します。モデルごとの上限は capabilities を確認してください。 | maxItems: 10 |
reference_videos[].type | string | 必須 | 参照入力の渡し方。URL、アセット ID、Base64 を区別します。 | "url", "asset_id", "base64" |
reference_videos[].url | string | 任意 | 参照メディアを取得できる URL。URL 形式で渡す場合に使用します。 | maxLength: 2048; format: "uri" |
reference_audio | (string / object)[] | 任意 | 参照音声を URL または種類付きのオブジェクトで指定します。モデルごとの上限と合計上限は capabilities を確認してください。 | maxItems: 50 |
reference_audio[].type | string | 必須 | 参照入力の渡し方。URL、アセット ID、Base64 を区別します。 | "url", "asset_id", "base64" |
reference_audio[].url | string | 任意 | 参照メディアを取得できる URL。URL 形式で渡す場合に使用します。 | maxLength: 2048; format: "uri" |
resolution | string | 任意 | 出力の解像度。モデルが対応する値をカタログで確認します。 | "360p", "480p", "540p", "720p", "768p", "1080p", "2K", "2k", "4K", "4k", "8K", "hd", "fhd" |
duration_seconds | integer | 任意 | 生成する動画の長さを秒で指定します。共通範囲は 1〜600 秒で、モデルごとの範囲も適用されます。 | minimum: 1; maximum: 600 |
aspect_ratio | string | 任意 | 出力の幅と高さの比。auto は入力画像に合わせます。モデルの対応値を確認してください。 | "auto", "adaptive", "21:9", "2:1", "16:9", "4:3", "1:1", "3:4", "9:16", "3:2", "2:3", "9:21" |
generate_audio | boolean | 任意 | 対応するモデルで動画と同時に音声を生成するかどうか。 | モデルの capabilities と constraints で確認 |
metadata | object | 任意 | 利用者の追跡用データ。ジョブと関連付けて保存し、モデルには送りません。 | モデルの capabilities と constraints で確認 |
mode | string | 任意 | async は即時応答、webhook は終端通知、sync と subscribe は時間を区切って完了を待ちます。 | "async", "sync", "subscribe", "webhook", "text_to_video", "image_to_video", "reference_to_video", "t2v", "i2v", "ref2va"; default: "async" |
webhook_url | string | 任意 | 終端イベントを受け取る公開 HTTPS URL(2048 文字以内、既定のポート)。async または webhook モードで指定し、sync とは併用できません。localhost、プライベート、ループバック、リンクローカルのアドレス宛ては指定できません。ジョブが完了、失敗、取消のいずれかになると、ワークスペースの署名シークレットで署名した通知を 1 件送ります。 | maxLength: 2048; format: "uri" |
wait_timeout_seconds | integer | 任意 | HTTP 応答を待つ秒数。0〜30。時間を過ぎてもジョブは継続します。 | minimum: 0; maximum: 30 |
project_id | string | 任意 | ジョブまたは配置先を関連付けるプロジェクトの ID。 | maxLength: 200 |
seed | integer | 任意 | 再現性の調整に使う乱数シード。0〜4,294,967,295。 | minimum: 0; maximum: 4294967295 |
task | string | 任意 | auto- の自動モデル選択に渡す制作意図。名前を指定したモデルでは使用しません。 | モデルの capabilities と constraints で確認 |
audio_url | string | 任意 | リップシンク用の音声の公開 HTTPS URL。顔画像には image_url、顔動画には video_url を使い、duration_seconds も指定します。 | format: "uri" |
model_params | object | 任意 | モデル固有設定の予約領域。現在は省略するか空オブジェクトを指定します。追加のキーは受け付けません。 | モデルの capabilities と constraints で確認 |
prompt_enhancement | string | 任意 | heygen-video-1 の文章補正。15 秒超では turbo、quality、default を使います。default は turbo と同じ指定です。 | "turbo", "quality", "ultraquality", "disabled", "default" |
end_user_id | string | 任意 | heygen-video-1 に渡す利用者の不透明な ID。1〜128 文字、空白と個人情報を含めません。 | minLength: 1; maxLength: 128 |
callback_id | string | 任意 | heygen-video-1 の追跡用 ID。最大 256 文字で metadata.callback_id に保存し、通知にも含めます。 | maxLength: 256 |
draft | boolean | 任意 | seedance-2.5 で 480p の下書きを作成します。duration_seconds が必須で、video_url、extend、source_duration、draft_job_id は併用できません。 | モデルの capabilities と constraints で確認 |
draft_job_id | string | 任意 | seedance-2.5 の完了済み下書きの ID。model と、この ID と任意の resolution: 1080p だけを送り、元の入力を引き継ぎます。作成後 14 日以内に使用します。 | モデルの capabilities と constraints で確認 |
extend | boolean | 任意 | seedance-2.5 で video_url の続きを生成します。duration_seconds は追加部分の 4〜30 秒です。 | モデルの capabilities と constraints で確認 |
source_duration | integer | 任意 | 延長する元動画の秒数を切り上げた整数。1〜30。seedance-2.5 の extend で使用し、省略時は 15 秒として料金を計算します。 | minimum: 1; maximum: 30 |
dubbing | object | 任意 | veed-dubbing の翻訳吹替設定。video_url と 2〜600 秒の duration_seconds が必要で、prompt・resolution・aspect_ratio は指定しません。 | 必須の子項目: target_language |
dubbing.target_language | string | 必須 | 吹替先の言語。ko などの BCP 47 基本言語タグで、地域付きのタグは指定できません。 | モデルの capabilities と constraints で確認 |
dubbing.source_language | string | 任意 | 入力動画の言語。省略または auto で自動判定します。 | モデルの capabilities と constraints で確認 |
captions | object | 任意 | veed-subtitles の字幕設定。video_url と 2〜600 秒の duration_seconds が必要です。課金対象は最低 60 秒、既定の resolution は 1080p です。 | 必須の子項目: style |
captions.style | string | 必須 | モデルカタログにある字幕のスタイル。動的なスタイルは通常の 2 倍の料金です。 | モデルの capabilities と constraints で確認 |
captions.srt | string | 任意 | 字幕として使う SRT 文字列。最大 100,000 文字。省略時は動画の音声を文字起こしします。 | maxLength: 100000 |
captions.position | string | 任意 | 字幕の表示位置。top は上、center は中央、bottom は下。 | "top", "center", "bottom" |
captions.shadow | string | 任意 | 字幕の影の強さ。省略すると選択したスタイルの設定を使います。 | "none", "min", "mid", "max" |
upscale | object | 任意 | topaz-video の拡大・補間設定。video_url と切り上げた 2〜60 秒の duration_seconds が必要です。30 fps 超、または fps の省略時は料金が 2 倍になります。 | モデルの capabilities と constraints で確認 |
upscale.factor | number | 任意 | 縦横それぞれの拡大倍率。1〜4、既定は 2。1 と fps の組み合わせでフレームレートだけを変更できます。 | minimum: 1; maximum: 4 |
upscale.fps | integer | 任意 | 補間後のフレームレート。16〜60。省略すると入力の値を維持します。 | minimum: 16; maximum: 60 |
upscale.model | string | 任意 | Topaz の補正モデル名。既定は Proteus。対応値はカタログで確認します。 | モデルの capabilities と constraints で確認 |
background | object | 任意 | sam-3.1-video の背景除去設定。prompt で残す対象を示し、video_url と切り上げた 2〜60 秒の duration_seconds を指定します。 | モデルの capabilities と constraints で確認 |
background.output | string | 任意 | 背景除去の結果。sam-3.1-video は cutout(元動画にマスクを適用)のみ対応し、mask は 400 を返します。既定は cutout。 | "cutout", "mask" |
depth | object | 任意 | 対応モデルの動画深度マップの描画設定。元動画の秒数を切り上げた duration_seconds と video_url を指定します。 | モデルの capabilities と constraints で確認 |
depth.colormap | string | 任意 | 深度の色付け。既定の grayscale は近くを白、遠くを黒にし、inferno と turbo は色で区別します。 | "grayscale", "inferno", "turbo" |
bitrate_mode | string | 任意 | 出力のビットレート設定。standard または high を対応モデルで使用します。 | "standard", "high" |
frame_images | (object)[] | 任意 | auto- で使用する開始・終了フレーム。最大 2 件で、image_url と併用できます。 | maxItems: 2 |
frame_images[].type | string | 必須 | 入力メディアの種類。対応する名前のオブジェクトに URL を指定します。 | "image_url" |
frame_images[].image_url | object | 必須 | 参照画像の URL を持つオブジェクト。 | 必須の子項目: url |
frame_images[].image_url.url | string | 必須 | 認証なしで取得でき、ジョブが終わるまで有効な公開 HTTPS URL。 | format: "uri" |
frame_images[].frame_type | string | 必須 | この画像を first_frame(開始)と last_frame(終了)のどちらに使うか。 | "first_frame", "last_frame" |
input_references | (object)[] | 任意 | auto- で使用する参照メディア。最大 20 件で、type と同じ種類の URL オブジェクトを指定します。 | maxItems: 20 |
input_references[].type | string | 必須 | 入力メディアの種類。対応する名前のオブジェクトに URL を指定します。 | "image_url", "audio_url", "video_url" |
input_references[].image_url | object | 任意 | 参照画像の URL を持つオブジェクト。 | 必須の子項目: url |
input_references[].image_url.url | string | 必須 | 認証なしで取得でき、ジョブが終わるまで有効な公開 HTTPS URL。 | format: "uri" |
input_references[].audio_url | object | 任意 | 参照音声の URL を持つオブジェクト。 | 必須の子項目: url |
input_references[].audio_url.url | string | 必須 | 認証なしで取得でき、ジョブが終わるまで有効な公開 HTTPS URL。 | format: "uri" |
input_references[].video_url | object | 任意 | 参照動画の URL を持つオブジェクト。 | 必須の子項目: url |
input_references[].video_url.url | string | 必須 | 認証なしで取得でき、ジョブが終わるまで有効な公開 HTTPS URL。 | format: "uri" |
カタログの対応範囲
| フィールド | 型 | 指定 | 意味 | 値と制約 |
|---|---|---|---|---|
name | string | 必須 | 選択画面などに表示する名称。 | モデルの capabilities と constraints で確認 |
modality | string | 必須 | モデルが生成するメディアの種類。 | "video" |
routing | string | 必須 | モデルへの入力の渡し方と呼び出し経路の情報。 | "pass_through" |
gated | boolean | 任意 | 追加の利用条件を満たす必要があるかどうか。 | モデルの capabilities と constraints で確認 |
capabilities | object | 必須 | テキスト生成・編集・参照入力など、このモデルが対応する機能。 | 必須の子項目: text_to_video, image_to_video, end_frame, reference_images, reference_videos, reference_audios, video_to_video, audio, resolutions, duration_seconds, aspect_ratios |
capabilities.max_reference_images | integer | 任意 | 受け付ける参照入力の最大数。 | minimum: 1 |
capabilities.max_reference_videos | integer | 任意 | 受け付ける参照入力の最大数。 | minimum: 1 |
capabilities.max_reference_audios | integer | 任意 | 受け付ける参照入力の最大数。 | minimum: 1 |
capabilities.max_reference_total | integer | 任意 | 参照入力の合計の最大数。 | minimum: 1 |
capabilities.operation_settings | object | 任意 | Provider-documented settings for each supported generation operation. | モデルの capabilities と constraints で確認 |
capabilities.text_to_video | boolean | 必須 | 文章から動画を生成できるかどうか。 | モデルの capabilities と constraints で確認 |
capabilities.image_to_video | boolean | 必須 | 最初のフレームとなる画像から動画を生成できるかどうか。 | モデルの capabilities と constraints で確認 |
capabilities.end_frame | boolean | 必須 | 最後のフレームを画像で指定できるかどうか。 | モデルの capabilities と constraints で確認 |
capabilities.reference_images | boolean | 必須 | 参照画像入力への対応条件。 | モデルの capabilities と constraints で確認 |
capabilities.reference_videos | boolean | 必須 | 参照動画入力への対応条件。 | モデルの capabilities と constraints で確認 |
capabilities.reference_audios | boolean | 必須 | 参照音声入力への対応条件。 | モデルの capabilities と constraints で確認 |
capabilities.video_to_video | boolean | 必須 | 入力動画を編集できるかどうか。 | モデルの capabilities と constraints で確認 |
capabilities.audio | boolean | 必須 | 音声の生成または入力への対応条件。 | モデルの capabilities と constraints で確認 |
capabilities.resolutions | (string)[] | 必須 | このモデルで指定できる出力解像度の一覧。 | モデルの capabilities と constraints で確認 |
capabilities.duration_seconds | object | 必須 | 指定可能な動画の秒数。モデルごとの範囲を確認してください。 | 必須の子項目: min, max |
capabilities.duration_seconds.min | integer | 必須 | 許可される値の下限。 | モデルの capabilities と constraints で確認 |
capabilities.duration_seconds.max | integer | 必須 | 許可される値の上限。 | モデルの capabilities と constraints で確認 |
capabilities.aspect_ratios | (string)[] | 必須 | このモデルで指定できる縦横比の一覧。 | モデルの capabilities と constraints で確認 |
capabilities.duration_seconds_by_mode | object | 任意 | 生成方式ごとの動画の長さの制約。 | モデルの capabilities と constraints で確認 |
capabilities.duration_seconds_by_mode.text_to_video | object | 任意 | 文章から動画を生成できるかどうか。 | 必須の子項目: min, max |
capabilities.duration_seconds_by_mode.text_to_video.min | integer | 必須 | 許可される値の下限。 | モデルの capabilities と constraints で確認 |
capabilities.duration_seconds_by_mode.text_to_video.max | integer | 必須 | 許可される値の上限。 | モデルの capabilities と constraints で確認 |
capabilities.duration_seconds_by_mode.image_to_video | object | 任意 | 最初のフレームとなる画像から動画を生成できるかどうか。 | 必須の子項目: min, max |
capabilities.duration_seconds_by_mode.image_to_video.min | integer | 必須 | 許可される値の下限。 | モデルの capabilities と constraints で確認 |
capabilities.duration_seconds_by_mode.image_to_video.max | integer | 必須 | 許可される値の上限。 | モデルの capabilities と constraints で確認 |
capabilities.duration_seconds_by_mode.reference_to_video | object | 任意 | 参照メディアを使って動画を生成できるかどうか。 | 必須の子項目: min, max |
capabilities.duration_seconds_by_mode.reference_to_video.min | integer | 必須 | 許可される値の下限。 | モデルの capabilities と constraints で確認 |
capabilities.duration_seconds_by_mode.reference_to_video.max | integer | 必須 | 許可される値の上限。 | モデルの capabilities と constraints で確認 |
capabilities.seed | boolean | 任意 | 再現性の調整に使う乱数シード。0〜4,294,967,295。 | モデルの capabilities と constraints で確認 |
capabilities.motion_control | boolean | 任意 | 動作参照動画のモーションをキャラクター画像に適用できるかを示します。 | モデルの capabilities と constraints で確認 |
capabilities.upscale | boolean | 任意 | 元の動画の解像度やフレームレートを上げられるかを示します。 | モデルの capabilities と constraints で確認 |
capabilities.lipsync | boolean | 任意 | 入力音声に合わせて映像内の口の動きを調整できるかを示します。 | モデルの capabilities と constraints で確認 |
capabilities.captions | boolean | 任意 | 動画への字幕の追加に対応しているかを示します。 | モデルの capabilities と constraints で確認 |
constraints | (string)[] | 必須 | モデルごとに受け付ける解像度、入力数、長さなどの制約。 | モデルの capabilities と constraints で確認 |
料金の形状
金額はカタログ取得時の値を使用します。単価と課金単位を組み合わせて見積もり、実際の消費量はジョブの usage で確認してください。
| フィールド | 型 | 指定 | 意味 | 値と制約 |
|---|---|---|---|---|
basis | string | 必須 | 画像数、秒数、解像度など、単価を適用する基準。 | "per_1000_video_tokens", "per_second", "per_second_by_resolution" |
credits_per_1000_video_tokens | number | 任意 | 動画トークン 1,000 個あたりの消費クレジット。 | minimum: 0 |
credits_per_second | number | 任意 | 動画 1 秒あたりの消費クレジット。 | minimum: 0 |
credits_per_second_audio_on | number | 任意 | 音声生成を有効にした場合の動画 1 秒あたりの消費クレジット。 | minimum: 0 |
credits_per_second_by_resolution | object | 任意 | 解像度ごとの動画 1 秒あたりの消費クレジット。 | モデルの capabilities と constraints で確認 |
usd_per_second | string | 任意 | 動画 1 秒あたりの USD 単価。 | pattern: "^\\d+\\.\\d{4,}$" |
usd_per_second_audio_on | string | 任意 | 音声生成を有効にした場合の動画 1 秒あたりの USD 単価。 | pattern: "^\\d+\\.\\d{4,}$" |
usd_per_second_by_resolution | object | 任意 | 解像度ごとの動画 1 秒あたりの USD 単価。 | モデルの capabilities と constraints で確認 |
usd_options | (object)[] | 任意 | 生成オプションによる USD 単価の差。 | モデルの capabilities と constraints で確認 |
usd_options[].label | string | 必須 | 画面に表示する項目の名前。 | モデルの capabilities と constraints で確認 |
usd_options[].resolution | string | 任意 | 出力の解像度。モデルが対応する値をカタログで確認します。 | モデルの capabilities と constraints で確認 |
usd_options[].audio | boolean | 任意 | 音声の生成または入力への対応条件。 | モデルの capabilities と constraints で確認 |
usd_options[].quality | string | 任意 | モデルが受け付ける生成品質。対応する値はカタログで確認します。 | モデルの capabilities と constraints で確認 |
usd_options[].usd | string | 必須 | 指定した処理の料金。単位は USD。 | pattern: "^\\d+\\.\\d{4,}$" |