Vidu Q4 Preview

対応しません。viduq4-previewには画像が必要で、I2Vでは先頭フレーム1枚、R2Vでは参照画像1〜15枚を使用します。R2Vは参照音声を最大3本追加できます。テキストのみの生成や開始・終了フレーム制御には対応しません。

first_frame_imageまたはfirst_frameロールでI2Vになります。ロールなしの画像1枚で参照音声がない場合もI2Vです。reference_image（別名reference）、複数画像、またはロールなし画像と参照音声の組み合わせはR2Vです。明示的な先頭フレームは参照画像・音声と混在できません。image_urlsとimage_with_rolesの参照画像は合計15枚まで。PNG、JPEG/JPG、WEBPは各50 MB以下、Base64リクエストは20 MB未満です。

I2Vのプロンプトは任意、R2Vでは必須で、いずれも最大20,000文字です。目的の動作や場面、参照素材をどう活用するかを指定できます。

長さは3〜16秒の整数（初期値5秒）、解像度は540p、720p、1080p、2K、4K（初期値720p）です。R2Vの縦横比は1:1、9:16、16:9、3:4、4:3で初期値16:9。aspect_ratioは別名sizeより優先されます。I2Vは両項目を無視し、先頭画像に従います。

生成音声は初期値trueで、falseなら同額で無音になります。R2Vの参照音声はMP3を0〜3本、各3〜12秒、50 MBまで。形式と長さは上流で確認され、不適合ならタスクが失敗し返金される場合があります。seedは整数で、省略または0ならランダムです。

I2VとR2Vは同じ料金体系で、長さに選択解像度の現在の秒単価を掛けます。参照画像・音声の素材追加料金はなく、生成音声の有無も同額です。実際のアカウント料金をご確認ください。失敗タスクは全額返金されます。

POST /v1/videos/generationsでtask_idを取得し、GET /v1/tasks/{task_id}を5〜10秒おきに照会します。completedまたはfailedまで続け、成功時はresult.videos[].urlから動画を取得します。

生成動画は72時間以内に保存し、タスク応答の期限情報も確認してください。照会のタイムアウトは生成失敗を意味しません。再送信せず、元のタスクの照会を再開してください。