Skip to main content
POST

認証

string
必須
すべてのAPIエンドポイントはBearer Token認証が必要ですAPIキーの取得:APIキー管理ページにアクセスしてAPIキーを取得してくださいリクエストヘッダーに追加:

リクエストパラメータ

string
必須
動画生成モデル名サポートされているモデル:
  • viduq3-pro - Vidu Q3 Pro
  • viduq3-turbo - Vidu Q3 Turbo
boolean
デフォルト:"false"
動画タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • trueomni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
テキストプロンプト、最大 2000 文字テキストから動画では必須。画像から動画および先頭・末尾フレームモードでは任意。例:"猫がピアノを弾いている、カメラがゆっくりズームイン"
integer
デフォルト:"5"
動画の長さ(秒)範囲:1 から 16デフォルト:5
string
デフォルト:"720p"
動画の解像度オプション:
  • 540p - 標準画質
  • 720p - HD(デフォルト)
  • 1080p - フルHD
デフォルト:720p
string
動画のアスペクト比(テキストから動画モードのみ)オプション:
  • 16:9 - 横向き
  • 9:16 - 縦向き
  • 4:3 - 従来型
  • 3:4 - 縦型従来型
  • 1:1 - 正方形
このパラメータはテキストから動画モード(image_urls を指定しない場合)でのみ使用できます。
array<url>
画像から動画生成用の画像URL配列システムは画像の数に基づいて生成モードを自動判定します:
  • 0枚(未指定):テキストから動画モード
  • 1枚:画像から動画モード(画像を開始フレームとして使用)
  • 2枚:先頭・末尾フレームモード(1枚目=先頭フレーム、2枚目=末尾フレーム)
例:["https://example.com/photo.jpg"]
  • 最大2枚まで
  • 先頭・末尾フレームモードでは正確に2枚の画像が必要です
  • image_urls を指定した場合(1枚でも2枚でも)、aspect_ratio パラメータは同時に使用できません。動画のアスペクト比は画像から自動的に決定されます
boolean
デフォルト:"true"
音声を生成するかどうか(セリフ、効果音)デフォルト:true無音動画が必要な場合は false に設定してください。
integer
生成内容のランダム性を制御するためのシード整数範囲:-12^32-1 の整数
  • 同じリクエストでも、異なる seed 値(未指定または -1 の場合はランダムな数値が使用されます)を渡すと、異なる結果が生成されます
  • 同じリクエストで同じ seed 値を渡すと、類似した結果が生成されますが、完全に一致することは保証されません

自動ルーティング

システムは image_urls の画像数に基づいて生成モードを自動判定します:

パラメータサポートマトリクス

レスポンス

integer
レスポンスステータスコード、成功時は200
array
レスポンスデータ配列

使用シーン

シーン 1:テキストから動画

シーン 2:画像から動画(1枚の画像)

シーン 3:先頭・末尾フレーム動画

シーン 4:音声なし(無音動画)

タスク結果の照会動画生成は非同期タスクです。送信後に task_id が返されます。タスクステータスの取得 エンドポイントで生成の進捗と結果を照会できます。