Skip to main content
POST

認証

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

リクエストパラメータ

string
必須
動画生成モデル名サポートされているモデル:
  • viduq3-mix - 総合画質王、スマート転場がより強力、1秒ショート動画対応
  • viduq3 - デフォルト推奨、カメラ切り替えがよりスマート
選び方:日常使いは viduq3、画質重視や1-2秒のモーションエフェクトには viduq3-mix
boolean
デフォルト:"false"
動画タスクを送信する前にコンテンツモデレーションを実行するかどうかを指定します。
  • trueomni-moderation-latest でプロンプトと入力画像を審査
  • false または省略:審査リクエストを行わず、審査コストや遅延を追加しない(デフォルト)
string
必須
テキストプロンプト、最大 5000 文字動作とカメラワークを記述し、外見は記述しないでください(外見は参照画像から決定されます)。例:"湖のほとりでサンタクロースとクマが抱き合っている"
array<url>
必須
参照画像URLの配列、1-7枚公開アクセス可能な画像URL(http:// または https://)をサポート例:["https://example.com/santa.png", "https://example.com/bear.png"]
  • 枚数:1-7枚
  • サポート形式:PNG、JPEG、JPG、WebP
  • 最小サイズ:128×128
  • アスペクト比:1:4 〜 4:1 の範囲
  • 1枚あたりのサイズ:≤ 50MB
  • 公開アクセス可能なURLである必要があります
integer
デフォルト:"5"
動画の長さ(秒)
  • viduq3-mix1 から 16
  • viduq33 から 16
デフォルト:5
viduq3 は最低3秒、viduq3-mix は最低1秒をサポートしています。選択したモデルに応じて有効な長さを指定してください。
string
デフォルト:"720p"
動画の解像度
  • viduq3-mix720p(デフォルト)/ 1080p
  • viduq3540p / 720p(デフォルト)/ 1080p
viduq3-mix540p をサポートしていません。720p または 1080p を使用してください。
string
デフォルト:"16:9"
動画のアスペクト比オプション:
  • 16:9 - 横向き(デフォルト)
  • 9:16 - 縦向き
  • 4:3 - 従来型
  • 3:4 - 縦型従来型
  • 1:1 - 正方形
integer
生成のランダム性を制御するランダムシード指定しない場合はランダムに生成されます。
同じパラメータで同じseed値を使用すると類似の結果が生成されますが、完全に同一であることは保証されません。

モデル比較

レスポンス

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

使用シーン

シーン 1:viduq3 基本参照画像から動画

シーン 2:viduq3-mix 高画質参照画像から動画

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