Skip to main content

Wan - ビデオ編集 (2.1)

Wan 2.1 統合ビデオ編集モデルは、テキスト、画像、ビデオなどの複数の入力モダリティをサポートし、幅広いビデオ生成および編集タスクに対応します。

関連ドキュメント:ユーザーガイド

適用範囲

呼び出しを成功させるには、モデル、エンドポイント URL、API キーが同じリージョンにある必要があります。リージョンをまたいだ呼び出しは失敗します。
  • モデルの選択:モデルのリージョンを確認します。
  • URL の選択:モデルのリージョンに対応するエンドポイント URL を選択します。HTTP URL がサポートされています。
  • API キーの設定:リージョンを選択し、API キーを取得し、環境変数に設定します。
このトピックのサンプルコードは、シンガポールリージョン向けです。
Alibaba Cloud Model Studio は、中国 (北京) およびシンガポールリージョン向けにワークスペース固有のドメインをリリースしました。新しい専用ドメインは、推論リクエストに対して優れたパフォーマンスと高い安定性を提供します。新しいドメインへの移行を推奨します:
  • 中国 (北京):https://dashscope.aliyuncs.com から https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
  • シンガポール:https://dashscope-intl.aliyuncs.com から https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com
{WorkspaceId} はワークスペース ID であり、Alibaba Cloud Model Studio コンソールの [ワークスペース詳細] ページで確認できます。既存のドメインも引き続き完全に機能します。

HTTP 呼び出し

統合ビデオ編集モデルの処理には 5〜10 分かかるため、API は非同期プロセスを使用します。これには、「タスクの作成 -> 結果のポーリング」という 2 つのコアステップが含まれます。

ステップ 1:タスクの作成

  • シンガポール
  • 北京
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis{WorkspaceId} を実際のワークスペース ID に置き換えてください。

リクエストパラメーター

リクエストヘッダー
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 (必須)プロンプトなどの基本入力。

プロパティ

promptstring(必須)生成されるビデオに含める要素や視覚的特徴を記述します。中国語と英語の両方をサポートします。最大長は 800 文字で、各漢字または英字は 1 文字としてカウントされます。この制限を超えたテキストは自動的に切り捨てられます。プロンプトのテクニックについては、「テキストからビデオ/画像からビデオへのプロンプトガイド」をご参照ください。functionstring(必須)機能名。複数画像参照は image_reference に設定されます。複数画像参照機能は、最大 3 つの参照画像をサポートします。画像には、人物、動物、衣服、風景などのエンティティや背景を含めることができます。prompt を使用して目的のビデオコンテンツを記述すると、モデルは複数の画像を組み合わせて一貫性のあるビデオコンテンツを生成できます。ref_images_urlarray[string] (必須)参照画像の URL の配列。
  1. パブリック URL:
1〜3 枚の参照画像を提供できます。3 枚を超えて提供した場合、最初の 3 枚のみが使用されます。画像要件:
  • フォーマット:JPG、JPEG、PNG、BMP、TIFF、または WEBP。
  • 解像度:幅と高さは [360, 2000] ピクセルの範囲内である必要があります。
  • サイズ:最大 10 MB。
  • URL には中国語文字を含めることはできません。
推奨事項:
  • エンティティに参照画像を使用する場合、各画像には 1 つのエンティティのみを含めることを推奨します。背景は、エンティティをより際立たせるために単色 (例:白) にすることを推奨します。
  • 参照画像から背景を使用する場合、最大で 1 枚の背景画像を提供でき、その画像にはエンティティオブジェクトを含めることはできません。
parameters object (任意)ウォーターマーク設定など、ビデオ処理用のパラメーター。

プロパティ

obj_or_bg array[string] (任意)このパラメーターは、各参照画像の目的を識別するために使用され、ref_images_url パラメーターと 1 対 1 で対応します。配列の各要素は、対応する位置の画像が「主題」か「背景」かを指定します:
  • obj:画像が参照エンティティであることを示します。
  • bg:画像を背景参照として指定します (最大 1 つまで許可)。
使用上の注意:
  • このパラメーターを渡すことを推奨します。その長さは ref_images_url と同じでなければならず、そうでなければエラーが報告されます。
  • このパラメーターは省略可能で、ref_images_url が単一要素の配列である場合にのみ、デフォルトで ["obj"] になります。
例:["obj", "obj", "bg"]。size string (任意)生成されるビデオの解像度 (幅*高さ)。モデルは 720p ビデオの生成をサポートします。有効な値:
  • 1280*720 (デフォルト):ビデオのアスペクト比は 16:9 で、1280 が幅、720 が高さです。
  • 720*1280:ビデオのアスペクト比は 9:16 です。
  • 960*960:ビデオのアスペクト比は 1:1 です。
  • 832*1088:ビデオのアスペクト比は 3:4 です。
  • 1088*832:ビデオのアスペクト比は 4:3 です。
duration integer (任意)生成されるビデオの長さ (秒単位)。この値は 5 に固定されています。prompt_extendbool (任意)プロンプトリライトを有効にするかどうかを指定します。有効にすると、大規模言語モデル (LLM) が入力プロンプトを書き換えます。これにより、短いプロンプトの結果が大幅に向上する可能性がありますが、処理時間が増加します。
  • true (デフォルト):プロンプトリライトを有効にします。
  • false:プロンプトリライトを無効にします。
seedinteger(任意)乱数シードは、モデルによって生成されるコンテンツのランダム性を制御します。seed パラメーターの値の範囲は [0, 2147483647] です。シードを指定しない場合、自動的に生成されます。再現可能な結果を得るには、複数のリクエストで同じシード値を使用してください。watermark bool(任意)画像の右下隅に「AI 生成」のウォーターマークを追加するかどうかを指定します。
  • false (デフォルト):ウォーターマークを追加しません。
  • true:ウォーターマークを追加します。
  • 複数画像参照
  • ビデオ再描画
  • ローカル編集
  • ビデオ拡張
  • ビデオアウトペインティング
シンガポールと中国 (北京) リージョンの API キーは異なります。API キーの取得
以下の URL はシンガポールリージョン用です。中国 (北京) リージョンの場合は、代わりに次の URL を使用してください:https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis
# 以下の URL はシンガポールリージョン用です。呼び出し時に、{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.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": "In the video, a girl gracefully emerges from a misty, ancient forest. Her steps are light, and the camera captures her every nimble moment. When she stops to look at the lush woods around her, a smile of surprise and joy blossoms on her face. This scene, frozen in an interplay of light and shadow, records her wonderful encounter with nature.",
        "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"
    }
}'

レスポンスパラメーター

output object非同期タスクの出力。

プロパティ

task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN:タスクが存在しないか、ステータスが不明です。
request_id stringトレースとトラブルシューティングのための一意なリクエスト識別子。code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。
  • 成功レスポンス
  • エラーレスポンス
task_id を保存して、タスクのステータスと結果をクエリします。
{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

ステップ 2:タスク ID による結果のクエリ

  • シンガポール
  • 中国 (北京)
GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id}{WorkspaceId} を実際のワークスペース ID に置き換えてください。

リクエストパラメーター

リクエストヘッダー
Authorization string (必須)Model Studio API キーでリクエストを認証します。例:Bearer sk-xxxx。
URL パスパラメーター
task_id string (必須)タスクの ID。
  • タスク結果のクエリ
{task_id} を、前の API 呼び出しで返された task_id の値に置き換えます。task_id は 24 時間クエリに有効です。{WorkspaceId} を実際のワークスペース ID に置き換えてください。
curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

レスポンスパラメーター

outputobjectタスクの出力に関する情報。

プロパティ

task_id stringタスク ID。24 時間クエリに有効です。task_status stringタスクのステータス。

列挙値

  • PENDING
  • RUNNING
  • SUCCEEDED
  • FAILED
  • CANCELED
  • UNKNOWN:タスクが存在しないか、ステータスが不明です。
submit_time stringタスクが送信された時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。scheduled_time stringタスクが実行された時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。end_time stringタスクが完了した時刻。時刻は UTC+8 で、フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。video_urlstring生成された MP4 (H.264) ビデオの URL。このリンクは 24 時間有効です。orig_prompt string元の入力プロンプト。actual_prompt stringプロンプトリライト後に生成に使用されたプロンプト。このフィールドは、プロンプトリライトが有効な場合にのみ返されます。code stringエラーコード。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。message string詳細なエラーメッセージ。失敗したリクエストに対してのみ返されます。「エラーコード」をご参照ください。
usage objectタスク出力の統計。これは成功したタスクに対してのみ提供されます。

プロパティ

video_duration integer生成されたビデオの長さ (秒単位)。video_ratio string生成されたビデオのアスペクト比。値は常に standard です。video_count integer生成されたビデオの数。
request_id stringトレースとトラブルシューティングのための一意なリクエスト識別子。
  • タスク成功
  • タスク失敗
タスクデータ (タスクステータスやビデオ URL を含む) は 24 時間利用可能で、その後自動的に削除されます。生成されたビデオは速やかに保存してください。
{
    "request_id": "851985d0-fbba-9d8d-a17a-xxxxxx",
    "output": {
        "task_id": "208e2fd1-fcb4-4adf-9fcc-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-05-15 16:14:44.723",
        "scheduled_time": "2025-05-15 16:14:44.750",
        "end_time": "2025-05-15 16:20:09.389",
        "video_url": "https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/xxx.mp4?xxxxxx",
        "orig_prompt": "In the video, a girl gracefully walks out from a misty, ancient forest. Her steps are light, and the camera captures her every nimble moment. When the girl stops and looks around at the lush woods, a smile of surprise and joy blossoms on her face. This scene, frozen in a moment of interplay between light and shadow, records her wonderful encounter with nature.",
        "actual_prompt": "A girl in a light-colored long dress slowly walks out from a misty, ancient forest, her steps as light as a dance. She has slightly curly long hair, a delicate face, and bright eyes. The camera follows her movements, capturing every nimble moment. When she stops, turns, and looks around at the lush woods, a smile of surprise and joy blossoms on her face. Sunlight filters through the leaves, casting mottled shadows and freezing this beautiful moment of harmony between human and nature. The style is a fresh and natural portrait, combining medium and full shots with a level perspective and slight camera movement."
    },
    "usage": {
        "video_duration": 5,
        "video_ratio": "standard",
        "video_count": 1
    }
}

制限事項

  • データ保持期間:タスク ID task_id とビデオ URL video_url は 24 時間のみ保持されます。有効期限が切れると、クエリやダウンロードはできなくなります。
  • 音声サポート:この機能は現在、無音のビデオのみを生成します。音声を生成するには、音声合成を使用してください。

エラーコード

モデルの呼び出しがエラーメッセージで失敗した場合は、「エラーコード」を参照してトラブルシューティングを行ってください。

よくある質問

Q:ビデオストレージドメインをホワイトリストに登録する方法は?

A:モデルによって生成されたビデオは OSS に保存されます。API は一時的なパブリック URL を返します。このダウンロード URL のファイアウォールホワイトリストを設定するには、次の点にご注意ください:基盤となるストレージは動的に変更される可能性があります。このトピックでは、古い情報によるアクセス問題を避けるため、固定の OSS ドメイン名ホワイトリストは提供していません。セキュリティ管理要件がある場合は、アカウントマネージャーに連絡して最新の OSS ドメイン名リストを入手してください。