Alibaba Cloud Model Studio:Wanxiang - 一般ビデオ編集 API リファレンス

prompt 文字列（必須）

生成されるビデオにおける望ましい要素および視覚的特徴を記述するプロンプト。

プロンプトは中国語または英語で記述でき、最大 800 文字までです。中国語の 1 文字または英字 1 文字はそれぞれ 1 文字としてカウントされます。超過分は自動的に切り捨てられます。

プロンプト技法の詳細については、「ビデオ生成プロンプトガイド」をご参照ください。

function 文字列（必須）

機能名を指定するパラメーターです。複数画像リファレンスの場合、この値を image_reference に設定します。

複数画像リファレンス機能は、最大 3 枚のリファレンス画像をサポートします。画像の内容には、人物、動物、衣装、シーンなどのエンティティおよびバックグラウンドが含まれます。prompt パラメーターを使用して、望ましいビデオの内容を記述します。モデルは、複数の画像を統合して一貫性のあるビデオを生成します。

ref_images_url 文字列配列 （必須）

入力リファレンス画像の URL の配列。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://xxx/xxx.mp3。

1～3 枚のリファレンス画像を指定できます。3 枚を超える画像を指定した場合、先頭の 3 枚のみが入力として使用されます。

画像要件:

• 画像フォーマット: JPG、JPEG、PNG、BMP、TIFF、WEBP。

• 画像解像度: 幅および高さは 360～2,000 ピクセルの間である必要があります。

• 画像サイズ: 10 MB を超えてはいけません。

• URL には中国語文字を含めないでください。

推奨事項:

• リファレンス画像からエンティティを使用する場合、各画像には 1 つのエンティティのみを含めるよう推奨します。バックグラウンドは白または単色など、エンティティをより際立たせるために純色であることが望ましいです。

• リファレンス画像からバックグラウンドを使用する場合、バックグラウンド画像は最大 1 枚までで、エンティティオブジェクトを含めてはいけません。

obj_or_bg 文字列配列 （任意）

各リファレンス画像の目的を識別するパラメーターであり、ref_images_url パラメーターと 1 対 1 で対応します。配列内の各要素は、対応する画像が「エンティティ」か「バックグラウンド」かを示します:

• obj: 画像はエンティティリファレンスとして使用されます。

• bg: 画像はバックグラウンドリファレンスとして使用されます。バックグラウンドリファレンスは最大 1 枚まで許可されます。

注意事項:

• このパラメーターの指定を推奨します。配列の長さは ref_images_url と一致させる必要があります。そうでない場合、エラーが報告されます。

• ref_images_url が 1 要素の配列である場合に限り、このパラメーターを省略できます。この場合、デフォルト値は ["obj"] となります。

例: ["obj", "obj", "bg"]。

size 文字列 （任意）

生成されるビデオの解像度（幅×高さ）。現在、モデルは 720P ビデオの生成をサポートしています。有効な値:

• 1280*720 （デフォルト）: 縦横比は 16:9。幅は 1280 ピクセル、高さは 720 ピクセル。

• 720*1280: 縦横比は 9:16。

• 960*960: 縦横比は 1:1。

• 832*1088: 縦横比は 3:4。

• 1088*832: 縦横比は 4:3。

duration 整数 （任意）

生成されるビデオの秒単位の再生時間。このパラメーターは固定値 5 であり、変更できません。モデルは常に 5 秒間のビデオを生成します。

prompt_extend ブール値 （任意）

プロンプトの再書き込みを有効にするかどうかを指定します。有効にすると、大規模言語モデル（LLM）が入力プロンプトを再書き込みします。これは短いプロンプトの生成品質を大幅に向上させますが、処理時間が延長されます。

• true （デフォルト）: プロンプトの再書き込みを有効にします。

• false: プロンプトの再書き込みを無効にします。

seed 整数 （任意）

乱数シードで、生成されるコンテンツのランダム性を制御します。シードパラメーターの値の範囲は [0, 2147483647] です。

シードを指定しない場合、アルゴリズムが自動的に乱数を生成してシードとして使用します。比較的安定したコンテンツを生成したい場合は、同じシードパラメーター値を使用してください。

watermark ブール値 （任意）

ウォーターマークを追加するかどうかを指定します。ウォーターマークは画像の右下隅に表示され、「AI-generated」という文字が記載されます。

• false （デフォルト）: ウォーターマークを追加しません。

• true: ウォーターマークを追加します。

prompt 文字列（必須）

生成されるビデオにおける望ましい要素および視覚的特徴を記述するプロンプト。

プロンプトは中国語または英語で記述でき、最大 800 文字までです。中国語の 1 文字または英字 1 文字はそれぞれ 1 文字としてカウントされます。超過分は自動的に切り捨てられます。

プロンプト技法の詳細については、「ビデオ生成プロンプトガイド」をご参照ください。

function 文字列（必須）

機能名です。ビデオ再ペイントの場合、値を video_repainting に設定します。

ビデオ再ペイントは、入力ビデオからエンティティのポーズおよび動作、構図および動きの輪郭、スケッチ構造を抽出します。その後、これらの情報をテキストプロンプトと組み合わせて、同じダイナミックな特徴を持つ新しいビデオを生成します。また、入力ビデオのエンティティをリファレンス画像で置き換えることも可能で、たとえば、元の動作を維持したままキャラクターの外見を変更できます。

video_url 文字列 （必須）

入力ビデオの URL。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://xxx/xxx.mp3。

ビデオ要件:

• ビデオフォーマット: MP4。

• ビデオフレームレート: 16 FPS 以上。

• ビデオサイズ: 50 MB を超えてはいけません。

• ビデオ再生時間: 5 秒を超えてはいけません。再生時間が長い場合、先頭の 5 秒のみが使用されます。

• URL には中国語文字を含めないでください。

出力ビデオの解像度について:

• 入力ビデオの解像度が 720P 以下の場合、出力は元の解像度を保持します。

• 入力ビデオの解像度が 720P より高い場合、元の縦横比を維持したまま 720P 以下にスケールダウンされます。

出力ビデオの再生時間について:

• 出力ビデオの再生時間は入力ビデオと同じですが、最大 5 秒までです。

• 例: 入力ビデオが 3 秒の場合、出力も 3 秒になります。入力が 6 秒の場合、出力は先頭の 5 秒になります。

ref_images_url 文字列配列 （任意）

入力リファレンス画像の URL の配列。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://xxx/xxx.mp3。

現在、1 枚 のみのリファレンス画像がサポートされています。この画像は、入力ビデオのエンティティを置き換えるために使用することを推奨します。

画像要件:

• 画像フォーマット: JPG、JPEG、PNG、BMP、TIFF、WEBP。

• 画像解像度: 幅および高さは 360～2,000 ピクセルの間である必要があります。

• 画像サイズ: 10 MB を超えてはいけません。

• URL には中国語文字を含めないでください。

推奨事項:

• リファレンス画像からエンティティを使用する場合、各画像には 1 つのエンティティのみを含めるよう推奨します。バックグラウンドは白または単色など、エンティティをより際立たせるために純色であることが望ましいです。

control_condition 文字列 （必須）

ビデオ特徴抽出の手法を設定します。

• posebodyface: 入力ビデオのエンティティの表情および身体の動きを抽出します。表情の詳細を保持する必要があるシナリオに適しています。

• posebody: 入力ビデオのエンティティの身体の動きを抽出しますが、表情は除外します。身体の動きのみを制御する必要があるシナリオに使用します。

• depth: 入力ビデオの構図および動きの輪郭を抽出します。

• scribble: 入力ビデオのスケッチ構造を抽出します。

strength 浮動小数点数 （任意）

control_condition 特徴抽出手法が生成ビデオに適用する制御強度を調整します。

デフォルト値は 1.0 です。値の範囲は [0.0, 1.0] です。

値が大きいほど、生成ビデオは元のビデオの動作および構図により近くなります。値が小さいほど、創造的な自由度が高まります。

prompt_extend ブール値 （任意）

プロンプトの再書き込みを有効にするかどうかを指定します。有効にすると、LLM が入力プロンプトを再書き込みします。これは短いプロンプトの生成品質を大幅に向上させますが、処理時間が延長されます。

• true （デフォルト）: プロンプトの再書き込みを有効にします。

• false: プロンプトの再書き込みを無効にします。（推奨）

テキストによる説明が入力ビデオの内容と不一致の場合、モデルがプロンプトを誤って解釈する可能性があります。生成の一貫性および正確性を向上させるため、プロンプトの再書き込みを無効にし、prompt に明確かつ具体的な説明を提供してください。

seed 整数 （任意）

乱数シードで、生成されるコンテンツのランダム性を制御します。シードパラメーターの値の範囲は [0, 2147483647] です。

シードを指定しない場合、アルゴリズムが自動的に乱数を生成してシードとして使用します。比較的安定したコンテンツを生成したい場合は、同じシードパラメーター値を使用してください。

watermark ブール値 （任意）

ウォーターマークを追加するかどうかを指定します。ウォーターマークは画像の右下隅に表示され、「AI-generated」という文字が記載されます。

• false （デフォルト）: ウォーターマークを追加しません。

• true: ウォーターマークを追加します。

prompt 文字列（必須）

生成されるビデオにおける望ましい要素および視覚的特徴を記述するプロンプト。

プロンプトは中国語または英語で記述でき、最大 800 文字までです。中国語の 1 文字または英字 1 文字はそれぞれ 1 文字としてカウントされます。超過分は自動的に切り捨てられます。

プロンプト技法の詳細については、「ビデオ生成プロンプトガイド」をご参照ください。

function 文字列（必須）

機能名です。ローカル編集の場合、値を video_edit に設定します。

ローカル編集では、入力ビデオの指定領域に対して要素の追加、変更、削除を行うことができます。また、編集領域のエンティティまたはバックグラウンドを置き換えることで、細かいレベルのビデオ編集を実現できます。

video_url 文字列 （必須）

入力ビデオの URL。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://xxx/xxx.mp3。

ビデオ要件:

• ビデオフォーマット: MP4。

• ビデオフレームレート: 16 FPS 以上。

• ビデオサイズ: 50 MB を超えてはいけません。

• ビデオ再生時間: 5 秒を超えてはいけません。再生時間が長い場合、先頭の 5 秒のみが使用されます。

• URL には中国語文字を含めないでください。

出力ビデオの解像度について:

• 入力ビデオの解像度が 720P 以下の場合、出力は元の解像度を保持します。

• 入力ビデオの解像度が 720P より高い場合、元の縦横比を維持したまま 720P 以下にスケールダウンされます。

出力ビデオの再生時間について:

• 出力ビデオの再生時間は入力ビデオと同じですが、最大 5 秒までです。

• 例: 入力ビデオが 3 秒の場合、出力も 3 秒になります。入力が 6 秒の場合、出力は先頭の 5 秒になります。

ref_images_url 文字列配列 （任意）

入力リファレンス画像の URL の配列。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://xxx/xxx.mp3。

現在、1 枚 のみのリファレンス画像がサポートされています。この画像は、入力ビデオの対応するコンテンツを置き換えるためにエンティティまたはバックグラウンドとして使用できます。

画像要件:

• 画像フォーマット: JPG、JPEG、PNG、BMP、TIFF、WEBP。

• 画像解像度: 幅および高さは 360～2,000 ピクセルの間である必要があります。

• 画像サイズ: 10 MB を超えてはいけません。

• URL には中国語文字を含めないでください。

推奨事項:

• リファレンス画像からエンティティを使用する場合、各画像には 1 つのエンティティのみを含めるよう推奨します。バックグラウンドは白または単色など、エンティティをより際立たせるために純色であることが望ましいです。

• リファレンス画像からバックグラウンドを使用する場合、バックグラウンド画像にはエンティティオブジェクトを含めてはいけません。

mask_image_url 文字列 （任意）

マスク画像の URL。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://xxx/xxx.mp3。

このパラメーターは、ビデオ編集エリアを指定します。このパラメーターまたは mask_video_url パラメーターのいずれかを指定する必要があります。このパラメーターを推奨します。

マスク画像の白い領域（画素値が正確に [255, 255, 255] の領域）は編集対象領域を示し、黒い領域（画素値が正確に [0, 0, 0] の領域）は保持対象領域を示します。

画像要件:

• 画像フォーマット: JPG、JPEG、PNG、BMP、TIFF、WEBP。

• 画像解像度: 入力ビデオ（video_url）の解像度と完全に一致する必要があります。

• 画像サイズ: 10 MB を超えてはいけません。

• URL には中国語文字を含めないでください。

mask_frame_id 整数 （任意）

mask_image_url が空でない場合にのみ使用されるパラメーターです。マスクされたオブジェクトが出現するフレームを「フレーム 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 文字列 （任意）

マスクビデオの URL。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://xxx/xxx.mp3。

このパラメーターは、動画の編集対象エリアを指定します。このパラメーターまたはmask_image_urlパラメーターのいずれかを指定する必要があります。

マスクビデオは、入力ビデオ（video_url）と同一のビデオフォーマット、フレームレート、解像度、長さである必要があります。

マスクビデオの白い領域（画素値が正確に [255, 255, 255] の領域）は編集対象領域を示し、黒い領域（画素値が正確に [0, 0, 0] の領域）は保持対象領域を示します。

control_condition 文字列 （任意）

ビデオ特徴抽出の手法を設定します。デフォルト値は ""（空文字列）であり、抽出を行わないことを意味します。

• posebodyface: 入力ビデオのエンティティの表情および身体の動きを抽出します。エンティティの顔がフレーム内で大きく、はっきりと見える特徴がある場合に適しています。

• depth: 入力ビデオの構図および動きの輪郭を抽出します。

mask_type 文字列 （任意）

mask_image_url が空でない場合にのみ有効になるパラメーターです。編集領域の動作を指定します。

• tracking （デフォルト）: 編集領域がターゲットオブジェクトの軌跡に動的に追随します。移動するオブジェクトがあるシーンに適しています。

• fixed: 編集領域は固定され、ビデオのコンテンツに応じて変化しません。

expand_ratio 浮動小数点数 （任意）

mask_type が tracking に設定されている場合に適用され、マスク領域の外側への拡張比率を指定します。

値の範囲は [0.0, 1.0] です。デフォルト値は 0.05 です。デフォルト値の使用を推奨します。

値が小さいほど、マスク領域はターゲットオブジェクトにより密接にフィットします。値が大きいほど、マスク領域はより広範囲に拡張されます。

expand_mode 文字列 （任意）

mask_type が tracking に設定されている場合に適用され、マスク領域の形状を指定します。

アルゴリズムは、入力マスク画像および選択された expand_mode に基づいて、対応する形状のマスクビデオを生成します。サポートされる値は以下のとおりです:

• hull （デフォルト）: ポリゴンモード。ポリゴンがマスクされたオブジェクトを囲みます。

• bbox: バウンディングボックスモード。矩形がマスクされたオブジェクトを囲みます。

• original: RAW モード。元のマスクされたオブジェクトの形状をできるだけ保持します。

size 文字列 （任意）

生成されるビデオの解像度（幅×高さ）。現在、モデルは 720P ビデオの生成をサポートしています。有効な値:

• 1280*720 （デフォルト）: 縦横比は 16:9。幅は 1280 ピクセル、高さは 720 ピクセル。

• 720*1280: 縦横比は 9:16。

• 960*960: 縦横比は 1:1。

• 832*1088: 縦横比は 3:4。

• 1088*832: 縦横比は 4:3。

duration 整数 （任意）

生成されるビデオの秒単位の再生時間。このパラメーターは固定値 5 であり、変更できません。モデルは常に 5 秒間のビデオを生成します。

prompt_extend ブール値 （任意）

プロンプトの再書き込みを有効にするかどうかを指定します。有効にすると、LLM が入力プロンプトを再書き込みします。これは短いプロンプトの生成品質を大幅に向上させますが、処理時間が延長されます。

• true （デフォルト）: プロンプトの再書き込みを有効にします。

• false: プロンプトの再書き込みを無効にします。（推奨）

テキストによる説明が入力ビデオの内容と不一致の場合、モデルがプロンプトを誤って解釈する可能性があります。生成の一貫性および正確性を向上させるため、プロンプトの再書き込みを無効にし、prompt に明確かつ具体的な説明を提供してください。

seed 整数 （任意）

乱数シードで、生成されるコンテンツのランダム性を制御します。シードパラメーターの値の範囲は [0, 2147483647] です。

シードを指定しない場合、アルゴリズムが自動的に乱数を生成してシードとして使用します。比較的安定したコンテンツを生成したい場合は、同じシードパラメーター値を使用してください。

watermark ブール値 （任意）

ウォーターマークを追加するかどうかを指定します。ウォーターマークは画像の右下隅に表示され、「AI-generated」という文字が記載されます。

• false （デフォルト）: ウォーターマークを追加しません。

• true: ウォーターマークを追加します。

prompt 文字列（必須）

生成されるビデオにおける望ましい要素および視覚的特徴を記述するプロンプト。

プロンプトは中国語または英語で記述でき、最大 800 文字までです。中国語の 1 文字または英字 1 文字はそれぞれ 1 文字としてカウントされます。超過分は自動的に切り捨てられます。

プロンプト技法の詳細については、「ビデオ生成プロンプトガイド」をご参照ください。

function 文字列（必須）

機能名です。ビデオ拡張の場合、値を video_extension に設定します。

ビデオ拡張は、画像またはビデオに基づいて連続したコンテンツを生成します。また、リファレンスビデオから動作や構図などのダイナミックな特徴を抽出し、同様の動きを持つビデオの生成をガイドします。

拡張されたビデオの総再生時間は 5 秒です。注: これは元のビデオに追加される 5 秒ではなく、最終出力ビデオの総再生時間です。

first_frame_url 文字列 （任意）

最初のフレーム画像の URL。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://xxx/xxx.mp3。

画像要件:

• 画像フォーマット: JPG、JPEG、PNG、BMP、TIFF、WEBP。

• 画像解像度: 幅および高さは 360～2,000 ピクセルの間である必要があります。

• 画像サイズ: 10 MB を超えてはいけません。

• URL には中国語文字を含めないでください。

last_frame_url 文字列（任意）

最後のフレーム画像の URL。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://xxx/xxx.mp3。

画像要件:

• 画像フォーマット: JPG、JPEG、PNG、BMP、TIFF、WEBP。

• 画像解像度: 幅および高さは 360～2,000 ピクセルの間である必要があります。

• 画像サイズ: 10 MB を超えてはいけません。

• URL には中国語文字を含めないでください。

first_clip_url 文字列 （任意）

最初のビデオセグメントの URL。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://xxx/xxx.mp3。

ビデオ要件:

• ビデオフォーマット: MP4。

• ビデオフレームレート: 16 FPS 以上。また、first_clip_url と last_clip_url の両方を指定する場合、両方のクリップのフレームレートを揃えることを推奨します。

• ビデオサイズ: 50 MB を超えてはいけません。

• ビデオ再生時間: 3 秒を超えてはいけません。再生時間が長い場合、先頭の 3 秒のみが使用されます。first_clip_url と last_clip_url の両方が指定されている場合、合計再生時間は 3 秒を超えてはいけません。

• URL には中国語文字を含めないでください。

出力ビデオの解像度について:

• 入力ビデオの解像度が 720P 以下の場合、出力は元の解像度を保持します。

• 入力ビデオの解像度が 720P より高い場合、元の縦横比を維持したまま 720P 以下にスケールダウンされます。

last_clip_url 文字列（任意）

最後のビデオセグメントの URL。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://help-static-aliyun-doc.aliyuncs.com/xxx.mp3。

ビデオ要件:

• ビデオフォーマット: MP4。

• ビデオフレームレート: 16 FPS 以上。first_clip_url と last_clip_url を併用する場合、両方のクリップのフレームレートを揃えることを推奨します。

• ビデオサイズ: 50 MB を超えてはいけません。

• ビデオ再生時間: 3 秒を超えてはいけません。再生時間が長い場合、先頭の 3 秒のみが使用されます。first_clip_url と last_clip_url の両方が指定されている場合、合計再生時間は 3 秒を超えてはいけません。

• URL には中国語文字を含めないでください。

出力ビデオの解像度について:

• 入力ビデオの解像度が 720P 以下の場合、出力は元の解像度を保持します。

• 入力ビデオの解像度が 720P より高い場合、元の縦横比を維持したまま 720P 以下にスケールダウンされます。

video_url 文字列 （任意）

入力ビデオの URL。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://help-static-aliyun-doc.aliyuncs.com/xxx.mp3。

このビデオは主にモーション特徴の抽出に使用されます。first_frame_url、last_frame_url、first_clip_url、および last_clip_url パラメーターと併用して、類似したモーションを持つ拡張ビデオの生成をガイドします。

ビデオ要件:

• ビデオフォーマット: MP4。

• ビデオフレームレート: 16 FPS 以上で、前後のクリップと整合性がある必要があります。

• ビデオ解像度: 前後のフレームおよびクリップと整合性がある必要があります。

• ビデオサイズ: 50 MB を超えてはいけません。

• ビデオ再生時間: 5 秒を超えてはいけません。再生時間が長い場合、先頭の 5 秒のみが使用されます。

• URL には中国語文字を含めないでください。

control_condition 文字列 （任意）

ビデオ特徴抽出の手法を設定します。video_url が指定されている場合、このパラメーターは必須です。デフォルト値は ""（空文字列）であり、抽出を行わないことを意味します。

• posebodyface: 入力ビデオからエンティティの表情および身体の動きを抽出します。

• depth: 入力ビデオの構図および動きの輪郭を抽出します。

duration 整数 （任意）

生成されるビデオの秒単位の再生時間。このパラメーターは固定値 5 であり、変更できません。モデルは常に 5 秒間のビデオを生成します。

prompt_extend ブール値 （任意）

プロンプトの再書き込みを有効にするかどうかを指定します。有効にすると、LLM が入力プロンプトを再書き込みします。これは短いプロンプトの生成品質を大幅に向上させますが、処理時間が延長されます。

• true （デフォルト）: プロンプトの再書き込みを有効にします。

• false: プロンプトの再書き込みを無効にします。（推奨）

テキストによる説明が入力ビデオの内容と不一致の場合、モデルがプロンプトを誤って解釈する可能性があります。生成の一貫性および正確性を向上させるため、プロンプトの再書き込みを無効にし、prompt に明確かつ具体的な説明を提供してください。

seed 整数 （任意）

乱数シードで、生成されるコンテンツのランダム性を制御します。シードパラメーターの値の範囲は [0, 2147483647] です。

シードを指定しない場合、アルゴリズムが自動的に乱数を生成してシードとして使用します。比較的安定したコンテンツを生成したい場合は、同じシードパラメーター値を使用してください。

watermark ブール値 （任意）

ウォーターマークを追加するかどうかを指定します。ウォーターマークは画像の右下隅に表示され、「AI-generated」という文字が記載されます。

• false （デフォルト）: ウォーターマークを追加しません。

• true: ウォーターマークを追加します。

prompt 文字列（必須）

生成されるビデオにおける望ましい要素および視覚的特徴を記述するプロンプト。

プロンプトは中国語または英語で記述でき、最大 800 文字までです。中国語の 1 文字または英字 1 文字はそれぞれ 1 文字としてカウントされます。超過分は自動的に切り捨てられます。

プロンプト技法の詳細については、「ビデオ生成プロンプトガイド」をご参照ください。

function 文字列（必須）

使用する機能を指定します。ビデオアウトペインティングの場合、このパラメーターを video_outpainting に設定します。

ビデオフレーム拡張は、上下左右方向への比例的なビデオ拡張を可能にします。

video_url 文字列 （必須）

入力ビデオの URL。

1. 公開 URL:

   • HTTP および HTTPS プロトコルをサポートします。

   • 例: https://xxx/xxx.mp3。

ビデオ要件:

• ビデオフォーマット: MP4。

• ビデオフレームレート: 16 FPS 以上。

• ビデオサイズ: 50 MB を超えてはいけません。

• ビデオ再生時間: 5 秒を超えてはいけません。再生時間が長い場合、先頭の 5 秒のみが使用されます。

• URL には中国語文字を含めないでください。

出力ビデオの解像度について:

• 入力ビデオの解像度が 720P 以下の場合、出力は元の解像度を保持します。

• 入力ビデオの解像度が 720P より高い場合、元の縦横比を維持したまま 720P 以下にスケールダウンされます。

出力ビデオの再生時間について:

• 出力ビデオの再生時間は入力ビデオと同じですが、最大 5 秒までです。

• 例: 入力ビデオが 3 秒の場合、出力も 3 秒になります。入力が 6 秒の場合、出力は先頭の 5 秒になります。

top_scale 浮動小数点数 （任意）

ビデオフレームを中央に配置し、上方向へ比例的に拡大します。

値の範囲は [1.0, 2.0] です。デフォルト値は 1.0 であり、拡大を行わないことを意味します。

bottom_scale 浮動小数点数 （任意）

ビデオフレームを中央に配置し、縦横比を維持して縮小します。

値の範囲は [1.0, 2.0] です。デフォルト値は 1.0 であり、拡大を行わないことを意味します。

left_scale 浮動小数点数 （任意）

ビデオフレームを中央に配置し、ビデオを左側に縦横比を維持してスケーリングします。

値の範囲は [1.0, 2.0] です。デフォルト値は 1.0 であり、拡大を行わないことを意味します。

right_scale 浮動小数点数 （任意）

ビデオフレームを中央に配置し、右方向へ比例的に拡大します。

値の範囲は [1.0, 2.0] です。デフォルト値は 1.0 であり、拡大を行わないことを意味します。

duration 整数 （任意）

生成されるビデオの秒単位の再生時間。このパラメーターは固定値 5 であり、変更できません。モデルは常に 5 秒間のビデオを生成します。

prompt_extend ブール値 （任意）

プロンプトの再書き込みを有効にするかどうかを指定します。有効にすると、LLM が入力プロンプトを再書き込みします。これは短いプロンプトの生成品質を大幅に向上させますが、処理時間が延長されます。

• true （デフォルト）: プロンプトの再書き込みを有効にします。

• false: プロンプトの再書き込みを無効にします。（推奨）

テキストによる説明が入力ビデオの内容と不一致の場合、モデルがプロンプトを誤って解釈する可能性があります。生成の一貫性および正確性を向上させるため、プロンプトの再書き込みを無効にし、prompt に明確かつ具体的な説明を提供してください。

seed 整数 （任意）

乱数シードで、生成されるコンテンツのランダム性を制御します。シードパラメーターの値の範囲は [0, 2147483647] です。

シードを指定しない場合、アルゴリズムが自動的に乱数を生成してシードとして使用します。比較的安定したコンテンツを生成したい場合は、同じシードパラメーター値を使用してください。

watermark ブール値 （任意）

ウォーターマークを追加するかどうかを指定します。ウォーターマークは画像の右下隅に表示され、「AI-generated」という文字が記載されます。

• false （デフォルト）: ウォーターマークを追加しません。

• true: ウォーターマークを追加します。