リクエストパラメーター | 複数画像参照シンガポールリージョンと中国 (北京) リージョンの API キーは異なります。詳細については、「API キーの取得」をご参照ください。 以下の URL はシンガポールリージョン用です。中国 (北京) リージョンのモデルを使用している場合は、URL を https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis に置き換える必要があります。 curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "image_reference",
"prompt": "ビデオでは、少女が霧のかかった古代の森から優雅に歩き出します。彼女の足取りは軽く、カメラは彼女の機敏な一瞬一瞬を捉えます。少女が立ち止まり、緑豊かな森を見回すと、驚きと喜びの笑みが彼女の顔に咲き誇ります。光と影が交錯する一瞬に凍結されたこのシーンは、彼女と自然との素晴らしい出会いを記録しています。",
"ref_images_url": [
"http://wanx.alicdn.com/material/20250318/image_reference_2_5_16.png",
"http://wanx.alicdn.com/material/20250318/image_reference_1_5_16.png"
]
},
"parameters": {
"prompt_extend": true,
"obj_or_bg": ["obj","bg"],
"size": "1280*720"
}
}'
ビデオ再描画シンガポールリージョンと中国 (北京) リージョンの API キーは異なります。詳細については、「API キーの取得」をご参照ください。 以下の URL はシンガポールリージョン用です。中国 (北京) リージョンのモデルを使用している場合は、URL を https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis に置き換える必要があります。 curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_repainting",
"prompt": "ビデオには、紳士が運転する黒いスチームパンクスタイルの車が映っています。車は歯車と銅管で飾られています。背景には蒸気動力のキャンディー工場とレトロな要素があり、ヴィンテージで遊び心のあるシーンを作り出しています。",
"video_url": "http://wanx.alicdn.com/material/20250318/video_repainting_1.mp4"
},
"parameters": {
"prompt_extend": false,
"control_condition": "depth"
}
}'
ローカル編集シンガポールリージョンと中国 (北京) リージョンの API キーは異なります。詳細については、「API キーの取得」をご参照ください。 以下の URL はシンガポールリージョン用です。中国 (北京) リージョンのモデルを使用している場合は、URL を https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis に置き換える必要があります。 curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_edit",
"prompt": "ビデオには、パリ風のフレンチカフェでスーツを着たライオンが優雅にコーヒーを飲んでいる様子が映っています。片手にコーヒーカップを持ち、リラックスした表情で優しく一口飲んでいます。カフェは趣味良く装飾され、柔らかな色合いと暖かい照明がライオンのいるエリアを照らしています。",
"mask_image_url": "http://wanx.alicdn.com/material/20250318/video_edit_1_mask.png",
"video_url": "http://wanx.alicdn.com/material/20250318/video_edit_2.mp4",
"mask_frame_id": 1
},
"parameters": {
"prompt_extend": false,
"mask_type": "tracking",
"expand_ratio": 0.05
}
}'
ビデオ拡張シンガポールリージョンと北京リージョンの API キーは異なります。詳細については、「準備:API キーの取得と設定」をご参照ください。 以下の URL はシンガポールリージョン用です。中国 (北京) リージョンのモデルを使用している場合は、URL を https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis に置き換える必要があります。 curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_extension",
"prompt": "サングラスをかけた犬が路上でスケートボードをしている、3D カートゥーン。",
"first_clip_url": "http://wanx.alicdn.com/material/20250318/video_extension_1.mp4"
},
"parameters": {
"prompt_extend": false
}
}'
ビデオアウトペインティングシンガポールリージョンと中国 (北京) リージョンの API キーは異なります。詳細については、「API キーの取得」をご参照ください。 以下の URL はシンガポールリージョン用です。中国 (北京) リージョンのモデルを使用している場合は、URL を https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis に置き換える必要があります。 curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "wan2.1-vace-plus",
"input": {
"function": "video_outpainting",
"prompt": "優雅な女性が情熱的にバイオリンを弾いており、その後ろにはフル編成の交響楽団がいます。",
"video_url": "http://wanx.alicdn.com/material/20250318/video_outpainting_1.mp4"
},
"parameters": {
"prompt_extend": false,
"top_scale": 1.5,
"bottom_scale": 1.5,
"left_scale": 1.5,
"right_scale": 1.5
}
}'
|
リクエストヘッダー |
Content-Type string (必須) リクエストのコンテンツタイプは application/json である必要があります。 |
Authorization string (必須) Model Studio API キーを使用した認証情報。 例:Bearer sk-xxxx |
X-DashScope-Async string (必須) 非同期処理を有効にします。HTTP リクエストは非同期処理のみをサポートするため、enable に設定する必要があります。
重要 含まれていない場合、「current user api does not support synchronous calls」エラーが返されます。 |
リクエストボディ |
複数画像参照model string (必須) モデル名。例:wan2.1-vace-plus。 input object (必須) プロンプトなどの基本的な入力情報。 プロパティ prompt string (必須) 生成するビデオに含めたい要素や視覚的特徴を記述するプロンプト。 プロンプトは中国語または英語で、800 文字を超えてはなりません。中国語の文字とアルファベットはそれぞれ 1 文字としてカウントされます。超過した文字は自動的に切り捨てられます。 プロンプトのテクニックに関する詳細については、「ビデオ生成プロンプトガイド」をご参照ください。 function string (必須) 機能の名前です。マルチイメージリファレンスの場合、 image_referenceに設定します。 マルチイメージリファレンス機能は、人物、動物、衣服、シーンなどのエンティティやバックグラウンドを含むことができる、最大 3 つのリファレンスイメージをサポートします。 prompt パラメーターを使用して、目的のビデオコンテンツを記述できます。 その後、モデルはこれらのイメージをマージして、一貫性のあるビデオを生成します。 ref_images_url array[string] (必須) 入力参照画像の URL の配列。 URL はインターネット経由でアクセス可能で、HTTP または HTTPS プロトコルをサポートしている必要があります。 1〜3 枚の参照画像を提供できます。3 枚を超える画像を提供した場合、最初の 3 枚のみが入力として使用されます。 画像要件: 画像フォーマット:JPG、JPEG、PNG、BMP、TIFF、または WEBP。 画像解像度:幅と高さは 360〜2,000 ピクセルの間である必要があります。 画像サイズ:10 MB を超えることはできません。 URL には中国語の文字を含めることはできません。
推奨事項: | parameters object (任意) ウォーターマーク設定などのビデオ処理パラメーター。 プロパティ obj_or_bg array[string] (任意) このパラメーターは、ref_images_url パラメーターと 1 対 1 で対応する配列です。この配列の各要素は、対応するイメージの用途が「エンティティ」か「バックグラウンド」のどちらであるかを指定します: 手順: 例:["obj", "obj", "bg"]。 size string (任意) 生成されるビデオの解像度 (幅*高さ)。モデルは現在、720P ビデオの生成をサポートしています。有効な値: duration integer (任意) 生成されるビデオの長さ (秒)。このパラメーターは 5 に固定されており、変更できません。モデルは常に 5 秒のビデオを生成します。 prompt_extend bool (任意) プロンプトの再書き込みを有効にするかどうかを指定します。有効にすると、大規模言語モデル (LLM) が入力プロンプトを再書き込みします。これにより、短いプロンプトで生成されるビデオの品質が大幅に向上しますが、処理時間が増加します。 seed integer (任意) ランダムシードは、生成されるコンテンツのランダム性を制御します。このパラメーターの値は [0, 2147483647] の範囲です。 シードを提供しない場合、アルゴリズムは自動的に乱数をシードとして生成します。生成されるコンテンツが比較的安定していることを保証するために、各リクエストで同じシード値を使用してください。 watermark bool (任意) ウォーターマークを追加するかどうかを指定します。ウォーターマークはビデオの右下隅に配置され、「AI-generated」と表示されます。 |
ビデオ再描画model string (必須) モデル名。例:wan2.1-vace-plus。 input object (必須) プロンプトなどの基本的な入力情報。 プロパティ prompt string (必須) 生成するビデオに含めたい要素や視覚的特徴を記述するプロンプト。 プロンプトは中国語または英語で、800 文字を超えてはなりません。中国語の文字とアルファベットはそれぞれ 1 文字としてカウントされます。超過した文字は自動的に切り捨てられます。 プロンプトのテクニックに関する詳細については、「ビデオ生成プロンプトガイド」をご参照ください。 function string (必須) 機能名です。ビデオ リペインティングの場合、値を video_repainting に設定します。 ビデオ再描画は、入力ビデオからエンティティのポーズとアクション、構図と動きの輪郭、線画構造を抽出します。モデルは、この情報をテキストプロンプトと組み合わせて、同じ動的特徴を持つ新しいビデオを生成します。また、元のビデオのエンティティを参照画像に置き換えることもできます。たとえば、元のアクションを保持しながらキャラクターの外見を変更するなどです。 video_url string (必須) 入力ビデオの URL。 URL はパブリックにアクセス可能で、HTTP または HTTPS プロトコルをサポートしている必要があります。 ビデオ要件: ビデオフォーマット:MP4。 ビデオフレームレート:16 FPS 以上。 ビデオサイズ:50 MB を超えることはできません。 ビデオの長さ:5 秒を超えることはできません。超える場合、最初の 5 秒のみが使用されます。 URL には中国語の文字を含めることはできません。
出力ビデオ解像度: 出力ビデオの長さ: ref_images_url array[string] (任意) 入力参照画像の URL の配列。URL はパブリックにアクセス可能なエンドポイントであり、HTTP または HTTPS プロトコルをサポートしている必要があります。 1 つの参照画像のみがサポートされています。この画像は、入力ビデオのエンティティを置き換えるために使用されるエンティティ画像であることを推奨します。 画像要件: 画像フォーマット:JPG、JPEG、PNG、BMP、TIFF、または WEBP。 画像解像度:幅と高さは 360〜2,000 ピクセルの間である必要があります。 画像サイズ:10 MB を超えることはできません。 URL には中国語の文字を含めることはできません。
推奨事項: | parameters object (必須) ウォーターマーク設定などのビデオ処理パラメーター。 プロパティ control_condition string (必須) ビデオ特徴抽出の方法を指定します。 posebodyface: 入力ビデオからエンティティの顔の表情と体の動きを抽出します。顔の詳細を保持する必要があるシナリオに適しています。
posebody: 入力ビデオから、顔の表情を除いたエンティティの体の動きを抽出します。これは、体の動きのみをコントロールする必要があるシナリオで使用します。
depth: 入力動画から構図と動きの輪郭を抽出します。
scribble: 入力動画から線画構造を抽出します。
strength float (任意) control_condition 特徴抽出メソッドが生成されたビデオに適用するコントロールの強度を調整します。
デフォルト値は 1.0 です。値の範囲は [0.0, 1.0] です。 値が大きいほど、生成されるビデオは元ビデオのアクションや構図に近くなります。値が小さいほど、より創造的な自由度が高まります。 prompt_extend bool (任意) プロンプトの再書き込みを有効にするかどうかを指定します。有効にすると、LLM が入力プロンプトを再書き込みします。これにより、短いプロンプトで生成されるビデオの品質が大幅に向上しますが、処理時間が増加します。 テキストによる説明が動画の内容と一致しない場合、モデルがプロンプトを誤って解釈する可能性があります。生成の一貫性と精度を向上させるには、プロンプトの書き換えを手動で無効にし、prompt に明確で具体的な説明を記述してください。 seed integer (任意) ランダムシードは、生成されるコンテンツのランダム性を制御します。このパラメーターの有効値は [0, 2147483647] です。 シードを提供しない場合、アルゴリズムは自動的に乱数をシードとして生成します。生成されるコンテンツが比較的安定していることを保証するために、各リクエストで同じシード値を使用してください。 watermark bool (任意) ウォーターマークを追加するかどうかを指定します。ウォーターマークはビデオの右下隅に配置され、「AI-generated」と表示されます。 |
ローカル編集model string (必須) モデル名。例:wan2.1-vace-plus。 input object (必須) プロンプトなどの基本的な入力情報。 プロパティ prompt string (必須) 生成するビデオに含めたい要素や視覚的特徴を記述するプロンプト。 プロンプトは中国語または英語で、800 文字を超えてはなりません。中国語の文字とアルファベットはそれぞれ 1 文字としてカウントされます。超過した文字は自動的に切り捨てられます。 プロンプトのテクニックに関する詳細については、「ビデオ生成プロンプトガイド」をご参照ください。 function string (必須) 機能の名前です。ローカル編集の場合、値を video_edit に設定します。 ローカル編集では、入力ビデオの指定されたエリアの要素を追加、変更、または削除できます。また、編集エリアのエンティティやバックグラウンドを置き換えて、詳細なビデオ編集を実現することもできます。 video_url string (必須) 入力ビデオの URL。 URL はパブリックにアクセス可能で、HTTP または HTTPS プロトコルをサポートしている必要があります。 ビデオ要件: ビデオフォーマット:MP4。 ビデオフレームレート:16 FPS 以上。 ビデオサイズ:50 MB を超えることはできません。 ビデオの長さ:5 秒を超えることはできません。超える場合、最初の 5 秒のみが使用されます。 URL には中国語の文字を含めることはできません。
出力ビデオ解像度: 出力ビデオの長さ: ref_images_url array[string] (任意) 入力参照画像の URL の配列。 URL はインターネット経由でアクセス可能なエンドポイントであり、HTTP または HTTPS プロトコルをサポートしている必要があります。 現在、1 つの参照画像のみがサポートされています。この画像は、入力ビデオの対応するコンテンツを置き換えるためのエンティティまたはバックグラウンドとして使用できます。 画像要件: 画像フォーマット:JPG、JPEG、PNG、BMP、TIFF、または WEBP。 画像解像度:幅と高さは 360〜2,000 ピクセルの間である必要があります。 画像サイズ:10 MB を超えることはできません。 URL には中国語の文字を含めることはできません。
推奨事項: mask_image_url string (任意) マスク画像の URL。URL はパブリック URL であり、HTTP または HTTPS プロトコルをサポートしている必要があります。 このパラメーターはビデオ編集 エリアを指定します。このパラメーターまたは mask_video_url パラメーターのいずれかを指定する必要があります。このパラメーターを推奨します。 マスク画像の白色エリア (ピクセル値 [255, 255, 255]) は編集する部分を示します。黒色エリア (ピクセル値 [0, 0, 0]) は保持するエリアを示します。 画像要件: 画像フォーマット:JPG、JPEG、PNG、BMP、TIFF、または WEBP。 イメージの解像度は、入力ビデオの解像度(video_url)と同じである必要があります。 画像サイズ:10 MB を超えることはできません。 URL には中国語の文字を含めることはできません。
mask_frame_id integer (任意) このパラメーターは、mask_image_url が Empty でない場合にのみ使用され、マスクされたオブジェクトが現れるビデオフレームのフレーム ID を指定します。 デフォルト値は 1 で、ビデオの最初のフレームを示します。 値は [1, max_frame_id] の範囲内である必要があります。ただし、max_frame_id = 入力ビデオフレームレート*入力ビデオのデュレーション+1 です。 例えば、フレームレートが 16 FPS、長さが 5 秒の入力ビデオ (video_url) の場合、総フレーム数は 81 (16*5 + 1) です。 したがって、max_frame_id の値は 81 です。 mask_video_url string (任意) マスクビデオの URL。この URL はインターネット経由でアクセス可能なエンドポイントであり、HTTP または HTTPS プロトコルをサポートしている必要があります。 このパラメーターは、編集するビデオのエリアを指定します。このパラメーターまたは mask_image_url パラメーターのいずれかを指定する必要があります。 マスクビデオのフォーマット、フレームレート、解像度、および長さは、入力ビデオ (video_url) と同じである必要があります。 マスクビデオの白色エリア (ピクセル値 [255, 255, 255]) は編集する部分を示します。黒色エリア (ピクセル値 [0, 0, 0]) は保持するエリアを示します。 | parameters object (任意) ウォーターマーク設定などのビデオ処理パラメーター。 プロパティ control_condition string (任意) ビデオ特徴抽出の方法を指定します。デフォルト値は "" で、抽出は行われません。 mask_type string (任意) このパラメーターは、mask_image_url が空でない場合にのみ有効です。編集エリアの動作を指定します。 expand_ratio float (任意) mask_type が tracking に設定されている場合、このパラメーターはマスクエリアの拡張率を指定します。
値の範囲は [0.0, 1.0] です。デフォルト値は 0.05 です。デフォルト値を使用することを推奨します。 値が小さいほど、マスクエリアはターゲットオブジェクトにより密接にフィットします。値が大きいほど、マスクエリアはより広く拡張されます。 expand_mode string (任意) このパラメーターは、mask_type が tracking に設定されている場合のマスクエリアの形状を指定します。 アルゴリズムは、入力マスクイメージと選択された expand_mode に基づいた形状のマスクビデオを生成します。次の値がサポートされています: hull (デフォルト):ポリゴンモード。ポリゴンがマスクされたオブジェクトを囲みます。
bbox: バウンディングボックスモード。マスクされたオブジェクトを矩形で囲みます。
original: RAW モード。マスクされたオブジェクトの元の形状を可能な限り維持します。
size string (任意) 生成されるビデオの解像度 (幅*高さ)。モデルは現在、720P ビデオの生成をサポートしています。有効な値: duration integer (任意) 生成されるビデオの長さ (秒)。このパラメーターは 5 に固定されており、変更できません。モデルは常に 5 秒のビデオを生成します。 prompt_extend bool (任意) プロンプトの再書き込みを有効にするかどうかを指定します。有効にすると、LLM が入力プロンプトを再書き込みします。これにより、短いプロンプトで生成されるビデオの品質が大幅に向上しますが、処理時間が増加します。 テキストの説明が動画コンテンツと一致しない場合、モデルはプロンプトを誤って解釈する可能性があります。生成の一貫性と精度を向上させるには、手動でプロンプトの書き換えを無効にし、 prompt に明確で具体的な説明を指定してください。 seed integer (任意) ランダムシードは、生成されるコンテンツのランダム性を制御します。このパラメーターの値は [0, 2147483647] の範囲です。 シードを提供しない場合、アルゴリズムは自動的に乱数をシードとして生成します。生成されるコンテンツが比較的安定していることを保証するために、各リクエストで同じシード値を使用してください。 watermark bool (任意) ウォーターマークを追加するかどうかを指定します。ウォーターマークはビデオの右下隅に配置され、「AI-generated」と表示されます。 |
ビデオ拡張model string (必須) モデル名。例:wan2.1-vace-plus。 input object (必須) プロンプトなどの基本的な入力情報。 プロパティ prompt string (必須) 生成するビデオに含めたい要素や視覚的特徴を記述するプロンプト。 プロンプトは中国語または英語で、800 文字を超えてはなりません。中国語の文字とアルファベットはそれぞれ 1 文字としてカウントされます。超過した文字は自動的に切り捨てられます。 プロンプトのテクニックに関する詳細については、「ビデオ生成プロンプトガイド」をご参照ください。 function string (必須) 機能の名前です。ビデオ拡張機能の場合、値は video_extension です。 ビデオ拡張は、画像またはビデオに基づいて連続したコンテンツの生成をサポートします。また、参照ビデオからアクションや構図などの動的特徴を抽出し、同様のモーションパフォーマンスを持つビデオの生成をガイドすることもサポートします。 拡張されたビデオの合計時間は 5 秒です。注意:これは最終的な出力ビデオの合計時間であり、元のビデオに追加される 5 秒の拡張ではありません。 first_frame_url string (任意) 最初のフレーム画像の URL。 URL は、HTTP または HTTPS プロトコルをサポートするパブリックエンドポイントである必要があります。 画像要件: 画像フォーマット:JPG、JPEG、PNG、BMP、TIFF、または WEBP。 画像解像度:幅と高さは 360〜2,000 ピクセルの間である必要があります。 画像サイズ:10 MB を超えることはできません。 URL には中国語の文字を含めることはできません。
last_frame_url string(任意) 最後のフレーム画像の URL。URL はインターネット経由でアクセス可能で、HTTP または HTTPS プロトコルをサポートしている必要があります。 画像要件: 画像フォーマット:JPG、JPEG、PNG、BMP、TIFF、または WEBP。 画像解像度:幅と高さは 360〜2,000 ピクセルの間である必要があります。 画像サイズ:10 MB を超えることはできません。 URL には中国語の文字を含めることはできません。
first_clip_url string (任意) 最初のビデオセグメントの URL。URL は、HTTP または HTTPS プロトコルをサポートするパブリックにアクセス可能なエンドポイントである必要があります。 ビデオ要件: ビデオフォーマット:MP4。 ビデオフレームレートは 16 FPS 以上にする必要があります。first_clip_url と last_clip_url の両方を使用する場合、2つのクリップのフレームレートを同じにすることを推奨します。 ビデオサイズ:50 MB を超えることはできません。 ビデオの長さは 3 秒を超えることはできません。 ビデオがこの制限を超えた場合、最初の 3 秒のみが使用されます。 first_clip_url と last_clip_url の両方が指定されている場合、それらの合計再生時間は 3 秒を超えることはできません。 URL には中国語の文字を含めることはできません。
出力ビデオ解像度: last_clip_url string(任意) 最後のビデオセグメントの URL。URL はインターネット経由でアクセス可能で、HTTP または HTTPS プロトコルをサポートしている必要があります。 ビデオ要件: ビデオフォーマット:MP4。 ビデオフレームレート:16 FPS 以上。 first_clip_url と last_clip_url を併用する場合、2 つのクリップのフレームレートを同じにすることを推奨します。 ビデオサイズ:50 MB を超えることはできません。 動画の長さ: 動画の最大長は 3 秒です。動画が 3 秒を超える場合、最初の 3 秒のみが使用されます。first_clip_url と last_clip_url の両方が指定されている場合、それらの合計の長さは 3 秒を超えることはできません。 URL には中国語の文字を含めることはできません。
出力ビデオ解像度: video_url string (任意) ビデオの URL。URL はパブリックにアクセス可能で、HTTP または HTTPS プロトコルをサポートしている必要があります。 このビデオは、モーションの特徴を抽出し、first_frame_url、last_frame_url、first_clip_url、および last_clip_url パラメーターを使用して、同様のモーションを持つ拡張ビデオを生成します。 ビデオ要件: ビデオフォーマット:MP4。 ビデオフレームレート:16 FPS 以上で、先行および後続のクリップと一致していること。 ビデオ解像度:先行および後続のフレームおよびクリップと一致していること。 ビデオサイズ:50 MB を超えることはできません。 ビデオの長さ:5 秒を超えることはできません。超える場合、最初の 5 秒のみが使用されます。 URL には中国語の文字を含めることはできません。
| parameters object (任意) 出力ビデオ解像度などのビデオ処理パラメーター。 プロパティ control_condition string (任意) ビデオ特徴抽出の方法を指定します。これは `video_url` が提供されている場合に必須です。デフォルト値は "" で、抽出は行われません。 duration integer (任意) 生成されるビデオの長さ (秒)。このパラメーターは 5 に固定されており、変更できません。モデルは常に 5 秒のビデオを生成します。 prompt_extend bool (任意) プロンプトの再書き込みを有効にするかどうかを指定します。有効にすると、LLM が入力プロンプトを再書き込みします。これにより、短いプロンプトで生成されるビデオの品質が大幅に向上しますが、処理時間が増加します。 テキストの説明が動画コンテンツと一致しない場合、モデルはプロンプトを誤って解釈する可能性があります。生成の一貫性と精度を向上させるには、手動でプロンプトの書き換えを無効にし、 prompt に明確で具体的な説明を指定してください。 seed integer (任意) ランダムシードは、生成されるコンテンツのランダム性を制御します。このパラメーターの有効値は [0, 2147483647] です。 シードを提供しない場合、アルゴリズムは自動的に乱数をシードとして生成します。生成されるコンテンツが比較的安定していることを保証するために、各リクエストで同じシード値を使用してください。 watermark bool (任意) ウォーターマークを追加するかどうかを指定します。ウォーターマークはビデオの右下隅に配置され、「AI-generated」と表示されます。 |
ビデオアウトペインティングmodel string (必須) モデル名。例:wan2.1-vace-plus。 input object (必須) プロンプトなどの基本的な入力情報。 プロパティ prompt string (必須) 生成するビデオに含めたい要素や視覚的特徴を記述するプロンプト。 プロンプトは中国語または英語で、800 文字を超えてはなりません。中国語の文字とアルファベットはそれぞれ 1 文字としてカウントされます。超過した文字は自動的に切り捨てられます。 プロンプトのテクニックに関する詳細については、「ビデオ生成プロンプトガイド」をご参照ください。 function string (必須) 使用する機能を指定します。ビデオアウトペインティングの場合、このパラメーターを video_outpainting に設定します。 ビデオアウトペインティングは、ビデオを上下左右の方向に比例的に拡大縮小することをサポートします。 video_url string (必須) 入力ビデオの URL。 URL はパブリックにアクセス可能で、HTTP または HTTPS プロトコルをサポートしている必要があります。 ビデオ要件: ビデオフォーマット:MP4。 ビデオフレームレート:16 FPS 以上。 ビデオサイズ:50 MB を超えることはできません。 ビデオの長さ:5 秒を超えることはできません。超える場合、最初の 5 秒のみが使用されます。 URL には中国語の文字を含めることはできません。
出力ビデオ解像度: 出力ビデオの長さ: | parameters object (任意) 拡大縮小率などのビデオ処理パラメーター。 プロパティ top_scale float (任意) ビデオフレームを中央に配置し、ビデオを上方向に比例的に拡大します。 値の範囲は [1.0, 2.0] です。デフォルト値は 1.0 で、拡大しないことを意味します。 bottom_scale float (任意) ビデオフレームを中央に配置し、縦横比を維持して縮小します。 値の範囲は [1.0, 2.0] です。デフォルト値は 1.0 で、拡大しないことを意味します。 left_scale float (任意) ビデオフレームを中央に配置し、ビデオを比例的に拡大縮小して左に寄せます。 値の範囲は [1.0, 2.0] です。デフォルト値は 1.0 で、拡大しないことを意味します。 right_scale float (任意) ビデオフレームを中央に配置し、ビデオを右方向に比例的に拡大します。 値の範囲は [1.0, 2.0] です。デフォルト値は 1.0 で、拡大しないことを意味します。 duration integer (任意) 生成されるビデオの長さ (秒)。このパラメーターは 5 に固定されており、変更できません。モデルは常に 5 秒のビデオを生成します。 prompt_extend bool (任意) プロンプトの再書き込みを有効にするかどうかを指定します。有効にすると、LLM が入力プロンプトを再書き込みします。これにより、短いプロンプトで生成されるビデオの品質が大幅に向上しますが、処理時間が増加します。 テキストの説明が動画コンテンツと一致しない場合、モデルがプロンプトを誤って解釈する可能性があります。生成の一貫性と精度を向上させるには、プロンプトの書き換えを手動で無効にし、prompt に明確で具体的な説明を提供してください。 seed integer (任意) 乱数シードは、生成されるコンテンツのランダム性を制御します。このパラメーターの値は [0, 2147483647] の範囲です。 シードを提供しない場合、アルゴリズムは自動的に乱数をシードとして生成します。生成されるコンテンツが比較的安定していることを保証するために、各リクエストで同じシード値を使用してください。 watermark bool (任意) ウォーターマークを追加するかどうかを指定します。ウォーターマークはビデオの右下隅に配置され、「AI-generated」と表示されます。 |
|