メインコンテンツへスキップ
POST
/
v3
/
async
/
vidu-q2-pro-startend2video
VIDU Q2 Pro 始端・終端フレーム
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-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種類の解像度に対応しています。
これは非同期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(任意)