Skip to main content
POST
Vidu Q3 動画生成
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。
  • 非同期タスク API。送信後に統一された generation.task を返します
  • 公開モデル: viduq3-pro-fast、viduq3-ad、viduq3-drama、viduq3-mix
viduq3-ad、viduq3-drama、viduq3-mix は純粋なテキストから動画生成モデルではありません。prompt のみを送信しないでください。参照素材が必要です。そうでない場合、上流は通常 InvalidParameter を返します。例: Missing required field 'subjects' in request body。

認証

string
必須
すべてのエンドポイントで Bearer Token 認証が必要です。

対応モデル

リクエストパラメータ

string
必須
次の 4 つの公開モデル名のみ対応しています:
  • viduq3-pro-fast
  • viduq3-ad
  • viduq3-drama
  • viduq3-mix
string
必須
プロンプト。参照生成モデルでも prompt を常に入力し、カメラワーク、動き、テンポ、スタイルを記述することをおすすめします。
string[]
参照画像 URL のリスト。
  • viduq3-pro-fast: 1 枚目の画像のみ使用され、先頭フレームになります
  • viduq3-ad / viduq3-drama / viduq3-mix: 被写体/スタイルの参照画像を 1 枚以上推奨
互換フィールド:
  • input_reference
  • reference_images
  • images
  • image
string
参照動画 URL。viduq3-ad / viduq3-drama / viduq3-mix のみ推奨。メインの参照動画 1 本を渡すのと同じ意味になります。
array
参照動画リスト。viduq3-ad / viduq3-drama / viduq3-mix のみ使用。各項目は以下をサポートします:
  • video_url
  • refer_type (任意)
  • keep_original_sound (任意)
integer
デフォルト:5
動画の長さ (秒)。デフォルト 5。
string
デフォルト:"720P"
解像度。720P、1080P をサポート。推奨:
  • viduq3-drama は 1080P を優先
boolean
音声を生成するかどうか。現在のサーバー側デフォルト動作:
  • viduq3-pro-fast: デフォルト true
  • viduq3-ad: デフォルト true
  • viduq3-mix: デフォルト true
  • viduq3-drama: 明示的に値を指定し、デフォルトに依存しないでください
boolean
デフォルト:false
透かしを追加するかどうか。
integer
ランダムシード。
object
拡張パラメータ。上流の動画リクエスト構造に従って透過的に渡されます。一般的な使い方:
  • metadata.input.first_frame_url
  • metadata.input.last_frame_url
  • metadata.input.audio_url
  • metadata.parameters.audio
  • metadata.parameters.watermark
viduq3-ad / viduq3-drama / viduq3-mix は上流側で被写体の構造化入力 (例: subjects) を要求する場合があります。プレーンテキストの prompt のみのリクエストは通常そのまま失敗します。

入力ルール

1. viduq3-pro-fast

  • 先頭フレーム画像から動画生成するモデル
  • 少なくとも 1 枚の画像が必要
  • 複数画像が渡された場合、現在は 1 枚目のみ使用
  • 「静止画を動かす」シーンに最適

2. viduq3-ad / viduq3-drama / viduq3-mix

  • 参照動画生成モデル。prompt のみの呼び出しは推奨しません
  • 最低限推奨する入力:
    • 参照動画 1 本: url または video_list
    • 参照画像 1 枚: image_urls または互換の画像フィールド
  • 被写体/参照素材が不足している場合、上流は以下を返すことがあります:
    • InvalidParameter
    • Missing required field 'subjects' in request body

リクエスト例

viduq3-pro-fast 先頭フレーム画像から動画生成

viduq3-ad 参照動画生成

viduq3-drama ドラマ型参照生成

viduq3-mix 混合参照生成

送信成功レスポンス

タスク照会

GET /v1/videos/generations/{task_id} 処理中:
成功:
失敗:

補足

  • 送信後、ToAPIs が上流タスクのステータスを一括でポーリングし、標準の動画タスク結果を返します。
  • viduq3-pro-fast は現在最も安定した接続形態で、先頭フレーム画像から動画生成に適しています。
  • viduq3-ad、viduq3-drama、viduq3-mix は参照素材の要件が厳しいため、接続前に上記の例に従って完全な素材を用意し、prompt のみは送らないでください。