Skip to main content

Wan 2.7 - Video Editing

Wanxiang ビデオ編集モデルは、入力ビデオに対してコンテンツの追加・削除・変更、背景の置き換え、スタイル変換、アクション・エフェクト・カメラワークの複製などの編集操作をサポートします。以下の 2 つの方法を提供しています。

  • 命令ベースの編集:テキスト命令を使用してビデオコンテンツを変更します。たとえば、キャラクターの衣装を置き換えたり、シーン要素を変更したり、ビジュアルスタイルを調整したりできます。
  • 命令とリファレンス画像による編集:命令に加えて、リファレンス画像を渡すことで、その画像のキャラクターや衣装、小道具などの要素をビデオに適用できます。
ビデオ編集、特に特定のビデオからアクションやカメラワーク、エフェクトを複製する場合は Video Editing 2.7 を使用してください。Wanxiang Image-to-Video 2.7 はビデオ継続機能を提供します。

開始方法

入力プロンプトおよびリファレンス画像入力ビデオ(エフェクトビデオ)出力ビデオ
リファレンスビデオの特殊効果を、画像内のロングヘアの女性に適用します。シーンはパーティーです。
image.png
呼び出しを行う前に、API キーを取得し、次にAPI キーを環境変数として設定してください。ソフトウェア開発キット(SDK)を使用して呼び出しを行う場合は、DashScope SDK をインストールしてください。 WorkspaceId は、実際のワークスペース IDに置き換えてください。
  • Python SDK
  • Java SDK
  • curl
次のコードを実行する前に、DashScope SDK for Python のバージョンが 少なくとも1.25.16 であることを確認してください。古いバージョンでは、「url error, please check url!」などのエラーが発生する可能性があります。詳細については、「SDK のインストール」を参照して更新してください。
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# 以下の URL はシンガポールリージョン用です。WorkspaceId は実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# 環境変数が設定されていない場合、次の行を Model Studio API キーで置き換えてください: api_key="sk-xxx"
# API キーはリージョンごとに異なります。詳細については https://www.alibabacloud.com/help/ja/model-studio/get-api-key を参照してください。
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/eclvbm/21_refined.mp4"
    },
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/jgekix/wan2.7-videoedit-demo.webp"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-videoedit",
        media=media,
        resolution="720P",
        prompt_extend=True,
        watermark=True,
        prompt="リファレンスビデオの特殊効果を、画像内のロングヘアの女性に適用します。シーンはパーティーです。",
    )
    print(rsp)
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

if __name__ == '__main__':
    sample_sync_call()
サンプル出力
video_url は 24 時間有効です。動画をすぐにダウンロードしてください。
{
    "request_id": "c1209113-8437-424f-a386-xxxxxx",
    "output": {
        "task_id": "966cebcd-dedc-4962-af88-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
         ...
    },
    ...
}

適用範囲

  • サポートされるモデルはリージョンによって異なります。リソースはリージョン間で分離されています。各リージョンでサポートされているモデルについては、Model Studio コンソールをご参照ください。
  • 呼び出しを行う際は、モデル、エンドポイント URL、API キーがすべて同じリージョンに属していることを確認してください。リージョンをまたいだ呼び出しは失敗します。
このトピックのサンプルコードは シンガポール リージョン向けです。

主要機能

命令のみによる編集

サポートモデル:wan2.7-videoedit。 機能概要:この機能は、入力ビデオとテキストプロンプトに基づいてビデオコンテンツを変更します。スタイル変換、アクション変更、カメラワーク調整などのシナリオに適しています。 パラメーター設定:
  • media:編集対象のビデオを指定します(type=video)。リファレンス画像は不要です。
  • prompt:編集の意図を記述します。例:「ビデオを 8 ビットピクセルスタイルに変更する」。
入力プロンプト入力ビデオ出力ビデオ
ビデオを 8 ビットピクセルスタイルに変更する
WorkspaceId は、実際のワークスペース IDに置き換えてください。
  • Python SDK
  • Java SDK
  • curl
次のコードを実行する前に、DashScope SDK for Python のバージョンが 1.25.16 以降であることを確認してください。古いバージョンでは、「url error, please check url!」などのエラーが発生する可能性があります。詳細については、「SDK のインストール」を参照して更新してください。
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# 以下の URL はシンガポールリージョン用です。WorkspaceId は実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# 環境変数が設定されていない場合、次の行を Model Studio API キーで置き換えてください: api_key="sk-xxx"
# API キーはリージョンごとに異なります。詳細については https://www.alibabacloud.com/help/ja/model-studio/get-api-key を参照してください。
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-videoedit",
        media=media,
        resolution="720P",
        prompt_extend=True,
        watermark=True,
        prompt="フレーム全体をクレイアニメーションスタイルに変換する",
    )
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

if __name__ == '__main__':
    sample_sync_call()

指示とリファレンスの画像編集

サポートモデル:wan2.7-videoedit。 機能概要:この機能は、テキストプロンプトに基づいて、リファレンス画像の衣装や小道具などの要素をビデオに適用します。 パラメーター設定:
  • media:編集対象のビデオ(type=video)とリファレンス画像(type=reference_image)を指定します。最大 4 枚のリファレンス画像を提供できます。
  • prompt:編集の意図を記述します。例:「ビデオ内の馬頭のキャラクターに、画像のストライプセーターを着せます」。
入力プロンプトおよびリファレンス画像入力ビデオ出力ビデオ
ビデオ内の馬頭のキャラクターに、画像のストライプセーターを着せます
2560154123_RF-jpeg
WorkspaceId は、実際のワークスペース IDに置き換えてください。
  • Python SDK
  • Java SDK
  • curl
次のコードを実行する前に、DashScope SDK for Python のバージョンが より前でない1.25.16 ことを確認してください。古いバージョンでは、「url error, please check url!」などのエラーが発生する可能性があります。詳細については、「SDK のインストール」を参照して更新してください。
# -*- coding: utf-8 -*-
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# 以下の URL はシンガポールリージョン用です。WorkspaceId は実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# 環境変数が設定されていない場合、次の行を Model Studio API キーで置き換えてください: api_key="sk-xxx"
# API キーはリージョンごとに異なります。詳細については https://www.alibabacloud.com/help/ja/model-studio/get-api-key を参照してください。
api_key = os.getenv("DASHSCOPE_API_KEY")

media = [
    {
        "type": "video",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260403/nlspwm/T2VA_22.mp4"
    },
    {
        "type": "reference_image",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/fwjpqf/wan2.7-videoedit-change-clothes.png"
    }
]

def sample_sync_call():
    print('----sync call, please wait a moment----')
    rsp = VideoSynthesis.call(
        api_key=api_key,
        model="wan2.7-videoedit",
        media=media,
        resolution="720P",
        prompt_extend=True,
        watermark=True,
        prompt="ビデオ内の女の子の服を、画像の服に置き換えます",
    )
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

if __name__ == '__main__':
    sample_sync_call()

利用シーンと例

要素の追加・削除・変更

ビデオ内の特定の要素を追加・削除・置き換えます。
タイプ入力プロンプトおよびリファレンス画像入力ビデオ出力ビデオ
追加カップに黒い正方形のチョコレートを追加する
削除ビデオから列車を削除します。他のすべてはそのままにします。
変更ビデオのフィルムを、画像のプレートに置き換えます
image.png
変更ビデオの馬男に、画像のストライプセーターを着せます
2560154123_RF-jpeg
変更猫を犬に変更する

環境または背景の変更

命令を使用して、ビデオの照明条件、季節の色合い、地理空間を変更します。また、ビデオの背景を変更して、オブジェクトを任意の空間に移動させることもできます。
タイプ入力プロンプト入力ビデオ出力ビデオ
季節の変更背景の季節を雪が積もった冬に変更します。川はそのままにしてください。
天候の変更キャラクターの動作はそのままにし、現在の曇り空から晴れの日に変更します。他のすべてはそのままにしてください。
照明と影の変更他のすべてはそのままにします。フレーム全体の光の色とフィルターを白から暖かいトーンに変更します。キャラクターの肌の色のディテールを維持し、キャラクターと背景の調和の取れた見た目を作ります。
背景の変更メインの女性の動作はそのままにし、ビデオの背景をジムに変更します。

ビデオスタイルの変更

既存のビデオをアニメーション、3D、クレイアニメーション、糸素材などさまざまなアートスタイルに素早く変換できます。
タイプ入力プロンプト入力ビデオ出力ビデオ
スタイル変更ビデオからイメージ:C4D カートゥーンスタイル
2402534429_RF
スタイル変更フレーム全体を実写映画スタイルに変換する
スタイル変更フレーム全体を水彩画スタイルに変換する

キャラクターの動作・セリフ・カメラワークの変更

既存または生成されたビデオコンテンツに対して、命令を使用してプロット(キャラクターの動作やセリフなど)を変更したり、カメラワークを調整したりして、さらにクリエイティブな編集が可能です。
タイプ入力プロンプト入力ビデオ出力ビデオ
キャラクターの動作変更ビデオ内の男性がスプーン一杯のスープをすくって飲みます。他のすべてはそのままにします。
キャラクターの感情変更フレーム内の女の子の表情が悲しみに変わり、泣き始めます。他のすべてはそのままにします。
キャラクターのセリフ変更キャラクターの声とトーンはそのままにします。左側の女の子のセリフを「ママ、これ何色?」に、右側の女の子のセリフを「グリーンよ、ベイビー」と変更します。
カメラワーク変更カメラの動きを、キャラクターを中心に時計回りに周回するものに変更し、キャラクターがカメラの動きに追随します。
カメラワーク変更ビデオのカメラの動きを、同時に下を向くチルトアップに変更します。

アクション・カメラワーク・エフェクトの複製

リファレンスビデオのアクションシーケンス、カメラ軌道、ビジュアルエフェクトを複製して、一貫した動的特徴を持つビデオを生成します。
タイプ入力プロンプトまたはリファレンス画像入力ビデオ出力ビデオ
単一人物のアクション複製画像内の人間に、ビデオ内の人間の動作を模倣させます。
image.png
複数人物のアクション複製ビデオ内の 5 人の動作をリファレンスとして、シーンを都市の路上の屋台で 5 人が歌いながら楽器を演奏しているものに変更します。
カメラワークの複製高速カメラモーションを持つ元のビデオのカメラワークをリファレンスとして、シーンを授賞式に変更し、リファレンス画像の女性がレッドカーペットを歩きます。
image.png
エフェクトの複製ビデオの特殊効果をリファレンスとして、画像内の女性に適用します。シーンは通りです。
image.png

ビデオおよび画像の入力方法

入力ビデオ

  • ビデオ数量:必須。1 つだけ。
  • 入力方法:
    • 公開 URL:HTTP または HTTPS プロトコルをサポートします。例:https://xxxx/xxx.mp4。

入力リファレンス画像

  • 画像数量:任意。最大 4 枚。
  • 入力方法:
    • 公開 URL:HTTP または HTTPS プロトコルをサポートします。例:https://xxxx/xxx.png。
    • Base64 エンコード文字列:例:data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABDg......(例は説明のために省略されています)。
      • フォーマット:data:{MIME_type};base64,{base64_data}。ここで:
        • {base64_data}:画像ファイルの Base64 エンコード文字列。
        • {MIME_type}:画像のメディアタイプ。ファイル形式に対応している必要があります。

        画像形式

        MIME タイプ

        JPEG

        image/jpeg

        JPG

        image/jpeg

        PNG

        image/png

        BMP

        image/bmp

        WEBP

        image/webp

        import base64
        import mimetypes
        
        # フォーマットは data:{MIME_type};base64,{base64_data}
        def encode_file(file_path):
            mime_type, _ = mimetypes.guess_type(file_path)
            if not mime_type or not mime_type.startswith("image/"):
                raise ValueError("サポートされていない、または認識できない画像形式です")
            with open(file_path, "rb") as image_file:
                encoded_string = base64.b64encode(image_file.read()).decode('utf-8')
            return f"data:{mime_type};base64,{encoded_string}"
        
        # your_image.jpg を実際の画像パスに置き換えてください
        base64_str = encode_file("your_image.jpg")
        print(base64_str)
        

出力ビデオ

課金とレート制限

  • モデルの無料クォータおよび課金価格については、「モデルの価格設定」をご参照ください。
  • モデルのレート制限については、「Wanxiang シリーズ」をご参照ください。
  • 課金の説明:
    • 入力画像は課金されません。入力ビデオおよび出力ビデオは秒単位で課金されます。計算式は次のとおりです:合計課金対象時間(秒) = 入力ビデオの長さ(秒) + 出力ビデオの長さ(秒)。
    • モデル呼び出しの失敗または処理エラーの場合、料金は発生せず、新規ユーザー向け無料クォータも消費しません。

API ドキュメント

Wanxiang Video Editing 2.7

よくある質問

Q:Video Editing 2.7(wan2.7-videoedit)と Video Editing 2.1(wan2.1-vace-plus)の違いは何ですか?

A:Video Editing 2.7 は命令に基づいて直接ビデオを編集するため、使い方が簡単で包括的なスペックアップが行われています。Video Editing 2.1 では function パラメーターを指定する必要があり、マスクを使用したローカル編集やフレーム拡張などの機能に重点を置いています。Video Editing 2.7 の使用を推奨します。

Q:複数のリファレンス画像を入力するにはどうすればよいですか?

A:media 配列に type=reference_image のオブジェクトを複数追加できます。最大 4 枚のリファレンス画像を追加できます。例:
{
    "media": [
        {"type": "video", "url": "<入力ビデオ URL>"},
        {"type": "reference_image", "url": "<リファレンス画像 1 URL>"},
        {"type": "reference_image", "url": "<リファレンス画像 2 URL>"},
        {"type": "reference_image", "url": "<リファレンス画像 3 URL>"},
        {"type": "reference_image", "url": "<リファレンス画像 4 URL>"}
    ]
}