メインコンテンツへスキップ
POST
/
v3
/
async
/
vidu-q2-pro-fast-startend2video
VIDU Q2 Pro Fast 始端・終端フレーム
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-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 枚の画像から一貫性のある動画を生成します（高速モード）。720p、1080p の 2 種類の解像度に対応しています。高速モードでは生成時間を大幅に短縮でき、速度要件の高いシーンに適しています。
これは非同期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 と 1080p に対応しています。デフォルト値は 720p です。選択可能な値：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
Provider request ID (optional)