メインコンテンツへスキップ
POST
/
v3
/
async
/
vidu-q2-turbo-startend2video
VIDU Q2 Turbo 始端・終端フレーム
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-turbo-startend2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "seed": 123,
  "images": [
    {}
  ],
  "is_rec": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "duration": 123,
  "off_peak": true,
  "meta_data": "<string>",
  "watermark": true,
  "resolution": "<string>",
  "wm_position": 123,
  "movement_amplitude": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
始端・終端の 2 枚の画像から、連続性のある動画を高速に生成します。540p、720p、1080p の 3 種類の解像度に対応しています。Turbo バージョンは、生成速度と動画品質のバランスを実現しています。
これは非同期API であり、非同期タスクの task_id のみを返します。この task_id を使用して タスク結果照会 API をリクエストし、生成結果を取得してください。

リクエストヘッダー

Content-Type
string
必須
列挙値: application/json
Authorization
string
必須
Bearer 認証形式: Bearer {{API Key}}。

リクエストボディ

bgm
boolean
デフォルト:false
生成された動画に背景音楽を追加するかどうか。true: システムがプリセット BGM ライブラリから適切な音楽を自動的に選択して追加します;false: BGM を追加しません。BGM の長さに制限はなく、システムが動画の長さに応じて自動的に調整します。
seed
integer
ランダムシード。デフォルトで未指定、または 0 を渡した場合は、ランダムな数値で代替されます。手動で設定した場合は、設定したシードが使用されます。
images
array
必須
画像配列。1 枚目の画像は始端フレーム画像、2 枚目の画像は終端フレーム画像として扱われ、モデルはこのパラメータで渡された画像を使用して動画を生成します。2 枚の画像入力に対応しています。注1: 始端・終端フレームの 2 枚の入力画像の解像度は近い必要があり、始端フレーム画像の解像度/終端フレーム画像の解像度は 0.8~1.25 の範囲内である必要があります;注2: 画像の Base64 エンコードまたは画像 URL(アクセス可能であること)を渡せます;注3: 画像は png、jpeg、jpg、webp 形式に対応しています;注4: 画像サイズは 50M を超えてはなりません;注5: Base64 エンコードには、適切なコンテンツタイプ文字列を含める必要があります。例:data:image/png;base64,配列長:2 - 2
is_rec
boolean
デフォルト:false
推奨プロンプトを使用するかどうか。true:はい。システムが自動的にプロンプトを推奨し、そのプロンプト内容を使用して動画を生成します(タスクごとに追加で 10 クレジットを消費);false:いいえ。入力された prompt に基づいて動画を生成します
prompt
string
テキストプロンプト。動画生成のためのテキスト説明です。注1:文字長は 2000 文字を超えてはなりません;注2:is_rec 推奨プロンプトパラメータを使用する場合、モデルはこのパラメータで入力されたプロンプトを考慮しません長さ制限:0 - 2000
wm_url
string
ウォーターマークの内容。ここでは画像 URL です。指定しない場合、デフォルトのウォーターマークを使用します:内容は AI によって生成されました
payload
string
パススルーパラメータ。いかなる処理も行わず、データ転送のみを行います。最大 1048576 文字です。長さ制限:0 - 1048576
duration
integer
デフォルト:5
動画の長さ(秒)。1~8 秒に対応しています選択可能な値:1, 2, 3, 4, 5, 6, 7, 8
off_peak
boolean
デフォルト:false
オフピークモード。true:オフピークで動画を生成します(消費クレジットがより低く、48 時間以内に生成);false:即時に動画を生成します。注:オフピークモードで送信されたタスクのうち、完了できなかったタスクは自動的にキャンセルされ、クレジットが返還されます。オフピークタスクを手動でキャンセルすることもできます。
meta_data
string
メタデータ識別子。json 形式の文字列で、パススルーフィールドです。形式をカスタマイズすることも、サンプル形式を使用することもできます。このパラメータが空の場合、デフォルトで vidu が生成したメタデータ識別子が使用されます。
watermark
boolean
デフォルト:false
ウォーターマークを追加するかどうか。デフォルトではウォーターマークを追加しません。watermarked_url パラメータを照会することで、ウォーターマーク付きの動画コンテンツを取得できます。
resolution
string
デフォルト:"720p"
出力動画の解像度。デフォルト値は 720p です。選択可能な値:540p, 720p, 1080p
wm_position
integer
デフォルト:3
ウォーターマークの位置。ウォーターマークが画像内に表示される位置を示します。1:左上;2:右上;3:右下(デフォルト);4:左下選択可能な値:1, 2, 3, 4
movement_amplitude
string
デフォルト:"auto"
モーション振幅。動画内のオブジェクトの動きの強さを制御します選択可能な値:auto, small, medium, large

レスポンス情報

task_id
string
必須
task_id を使用して タスク結果照会 API をリクエストし、生成された出力を取得します。
provider_request_id
string
プロバイダーリクエスト ID(任意)