Copy

指令編輯：通過文字指令修改視頻內容，如替換人物服飾、更改情境元素、調整畫面風格等。
指令+參考圖編輯：除指令外，還支援傳入參考映像，將映像中的元素（如人物、服飾、道具）應用到視頻中。

視頻編輯（尤其是複刻指定視頻的動作/運鏡/特效）推薦使用視頻編輯 2.7。若需視頻續寫能力，推薦使用萬相2.7-圖生視頻。

快速開始

輸入提示詞和參考圖	輸入視頻（特效視頻）	輸出視頻
參考視頻的特效，將這個特效應用到圖片中的這個長發的女人身上，情境為晚會。

在調用前，先擷取API Key，再配置API Key到環境變數。通過SDK進行調用，請安裝DashScope SDK。

Python SDK
Java SDK
curl

請確保 DashScope Python SDK 版本不低於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不同。擷取URL：https://www.alibabacloud.com/help/en/model-studio/wan-video-editing-api-reference
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# 若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx"
# 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/en/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()

請確保 DashScope Java SDK 版本不低於2.22.14，再運行以下代碼。若版本過低，可能會觸發 "url error, please check url!" 等錯誤。請參考安裝SDK進行更新。

// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.util.ArrayList;
import java.util.List;

public class VideoEdit {

    static {
        // 以下為新加坡地區的URL。調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // 若沒有配置環境變數，請用百鍊API Key將下行替換為：apiKey="sk-xxx"
    // 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/en/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void syncCall() {
        VideoSynthesis videoSynthesis = new VideoSynthesis();
        final String prompt = "參考視頻的特效，將這個特效應用到圖片中的這個長發的女人身上，情境為晚會。";
        List<VideoSynthesisParam.Media> media = new ArrayList<VideoSynthesisParam.Media>(){{
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/eclvbm/21_refined.mp4")
                    .type("video")
                    .build());
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/jgekix/wan2.7-videoedit-demo.webp")
                    .type("reference_image")
                    .build());
        }};
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.7-videoedit")
                        .prompt(prompt)
                        .media(media)
                        .resolution("720P")
                        .promptExtend(true)
                        .watermark(true)
                        .build();
        VideoSynthesisResult result = null;
        try {
            System.out.println("---sync call, please wait a moment----");
            result = videoSynthesis.call(param);
        } catch (ApiException | NoApiKeyException e){
            throw new RuntimeException(e.getMessage());
        } catch (InputRequiredException e) {
            throw new RuntimeException(e);
        }
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        syncCall();
    }
}

步驟1：建立任務擷取任務ID

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.7-videoedit",
    "input": {
        "prompt": "參考視頻的特效，將這個特效應用到圖片中的這個長發的女人身上，情境為晚會。",
        "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"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "prompt_extend": true,
        "watermark": true
    }
}'

步驟2：根據任務ID擷取結果將{task_id}完整替換為上一步介面返回的task_id的值。task_id查詢有效期間為24小時。

curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

輸出樣本

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",
         ...
    },
    ...
}

適用範圍

各地區支援的模型有所差異，且資源相互獨立。各地區支援的模型請參見百鍊控制台。
調用時，確保模型、Endpoint URL 和 API Key 均屬於同一地區，跨地區調用將會失敗。

本文的範例程式碼適用於新加坡地區。

核心能力

純指令編輯

支援模型：wan2.7-videoedit。 功能介紹：僅傳入的視訊和文本提示詞，通過指令直接修改視頻內容。適用於風格轉換、動作修改、運鏡調整等情境。 參數設定：

media：傳入一個待編輯的視頻（type=video），無需傳入參考映像。
prompt：描述編輯意圖，如“視頻改為8bit像素風格”。

輸入提示詞	輸入視頻	輸出視頻
視頻改為8bit像素風格

Python SDK
Java SDK
curl

請確保 DashScope Python SDK 版本不低於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不同。擷取URL：https://www.alibabacloud.com/help/en/model-studio/wan-video-editing-api-reference
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# 若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx"
# 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/en/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()

請確保 DashScope Java SDK 版本不低於2.22.14，再運行以下代碼。若版本過低，可能會觸發 "url error, please check url!" 等錯誤。請參考安裝SDK進行更新。

// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.util.ArrayList;
import java.util.List;

public class VideoEdit {

    static {
        // 以下為新加坡地區的URL。調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // 若沒有配置環境變數，請用百鍊API Key將下行替換為：apiKey="sk-xxx"
    // 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/en/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void syncCall() {
        VideoSynthesis videoSynthesis = new VideoSynthesis();
        final String prompt = "將整個畫面轉換為黏土風格";
        List<VideoSynthesisParam.Media> media = new ArrayList<VideoSynthesisParam.Media>(){{
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/ldnfdf/wan2.7-videoedit-style-change.mp4")
                    .type("video")
                    .build());
        }};
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.7-videoedit")
                        .prompt(prompt)
                        .media(media)
                        .resolution("720P")
                        .promptExtend(true)
                        .watermark(true)
                        .build();
        VideoSynthesisResult result = null;
        try {
            System.out.println("---sync call, please wait a moment----");
            result = videoSynthesis.call(param);
        } catch (ApiException | NoApiKeyException e){
            throw new RuntimeException(e.getMessage());
        } catch (InputRequiredException e) {
            throw new RuntimeException(e);
        }
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        syncCall();
    }
}

步驟1：建立任務擷取任務ID

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.7-videoedit",
    "input": {
        "prompt": "視頻改為8bit像素風格",
        "media": [
            {
                "type": "video",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20260409/rkjvku/1.mp4"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "prompt_extend": true,
        "watermark": true
    }
}'

步驟2：根據任務ID擷取結果將{task_id}完整替換為上一步介面返回的task_id的值。task_id查詢有效期間為24小時。

curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

指令+參考圖編輯

支援模型：wan2.7-videoedit。 功能介紹：傳入的視訊、文本提示詞和參考映像，將參考圖中的元素（如服飾、道具等）應用到視頻中。 參數設定：

media：傳入一個待編輯的視頻（type=video）和參考映像（type=reference_image）。最多支援4張參考映像。
prompt：描述編輯意圖，如“讓視頻中的馬頭人身角色穿上圖片中的條紋毛衣”。

輸入提示詞和參考圖	輸入視頻	輸出視頻
讓視頻中的馬頭人身角色穿上圖片中的條紋毛衣

Python SDK
Java SDK
curl

請確保 DashScope Python SDK 版本不低於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不同。擷取URL：https://www.alibabacloud.com/help/en/model-studio/wan-video-editing-api-reference
dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

# 若沒有配置環境變數，請用百鍊API Key將下行替換為：api_key="sk-xxx"
# 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/en/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()

請確保 DashScope Java SDK 版本不低於2.22.14，再運行以下代碼。若版本過低，可能會觸發 "url error, please check url!" 等錯誤。請參考安裝SDK進行更新。

// Copyright (c) Alibaba, Inc. and its affiliates.

import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesis;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisParam;
import com.alibaba.dashscope.aigc.videosynthesis.VideoSynthesisResult;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.utils.Constants;
import com.alibaba.dashscope.utils.JsonUtils;

import java.util.ArrayList;
import java.util.List;

public class VideoEdit {

    static {
        // 以下為新加坡地區的URL。調用時請將{WorkspaceId}替換為真實的業務空間ID，各地區的URL不同。
        Constants.baseHttpApiUrl = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }

    // 若沒有配置環境變數，請用百鍊API Key將下行替換為：apiKey="sk-xxx"
    // 各地區的API Key不同。擷取API Key：https://www.alibabacloud.com/help/en/model-studio/get-api-key
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    public static void syncCall() {
        VideoSynthesis videoSynthesis = new VideoSynthesis();
        final String prompt = "將視頻中女孩的衣服替換為圖片中的衣服";
        List<VideoSynthesisParam.Media> media = new ArrayList<VideoSynthesisParam.Media>(){{
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260403/nlspwm/T2VA_22.mp4")
                    .type("video")
                    .build());
            add(VideoSynthesisParam.Media.builder()
                    .url("https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260402/fwjpqf/wan2.7-videoedit-change-clothes.png")
                    .type("reference_image")
                    .build());
        }};
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wan2.7-videoedit")
                        .prompt(prompt)
                        .media(media)
                        .resolution("720P")
                        .promptExtend(true)
                        .watermark(true)
                        .build();
        VideoSynthesisResult result = null;
        try {
            System.out.println("---sync call, please wait a moment----");
            result = videoSynthesis.call(param);
        } catch (ApiException | NoApiKeyException e){
            throw new RuntimeException(e.getMessage());
        } catch (InputRequiredException e) {
            throw new RuntimeException(e);
        }
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        syncCall();
    }
}

步驟1：建立任務擷取任務ID

curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.7-videoedit",
    "input": {
        "prompt": "讓視頻中的馬頭人身角色穿上圖片中的條紋毛衣",
        "media": [
            {
                "type": "video",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/dozxak/Wan_Video_Edit_33_1.mp4"
            },
            {
                "type": "reference_image",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260415/hynnff/wan-video-edit-clothes.webp"
            }
        ]
    },
    "parameters": {
        "resolution": "720P",
        "prompt_extend": true,
        "watermark": true
    }
}'

步驟2：根據任務ID擷取結果將{task_id}完整替換為上一步介面返回的task_id的值。task_id查詢有效期間為24小時。

curl -X GET https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

使用情境及效果樣本

添加/刪除/修改元素

對視頻內特定元素進行添加、刪除或替換。

類型	輸入提示詞和參考圖	輸入視頻	輸出視頻
添加	杯子裡加一塊黑色正方形巧克力
刪除	將視頻中的火車刪除，其他保持不變。
修改	將視頻中的膠片替換為圖片中的盤子
修改	讓視頻中的馬男穿上圖片中的條紋毛衣
修改	把貓換成狗

修改環境或背景

通過指令變換視頻的光照條件、季節色彩，修改地理空間，也支援變換視頻背景，讓物體穿越到任意空間。

類型	輸入提示詞	輸入視頻	輸出視頻
修改季節	背景修改季節為白雪皚皚的冬天，樹上全是積雪，河流保持不變。
修改天氣	人物動作不變，整個情境由現在的陰天改為晴天，其他保持不變
修改光影	其他保持不變，畫面整體的光的顏色和濾鏡由白色變為暖色調，保持人物膚色細節，使人物與背景統一和諧。
修改背景	主體女人動作不變，將視頻背景修改為健身房。

修改視頻風格

將既有視頻快速轉化為多種藝術風格，如動畫、3D、黏土、毛線等。

類型	輸入提示詞	輸入視頻	輸出視頻
修改風格	視頻改為圖片的C4D卡通風格
修改風格	將整個畫面轉變為真人電影風格
修改風格	將整個畫面轉換為水彩畫風格

修改角色行為/台詞/拍攝方式

對已經拍攝或產生的視頻內容，通過指令修改劇情內容（如角色行為或台詞）和拍攝方法，實現二次創作。

類型	輸入提示詞	輸入視頻	輸出視頻
修改角色行為	讓視頻裡的男人盛一勺湯並喝下，其他保持不變。
修改角色情緒	畫面中的女孩表情變得悲傷並開始流淚，其他保持不變。
修改角色台詞	保持人物音色和語氣，將左邊女生的說話內容改為：“Mom, what color is this?”，將右邊女生說話內容改為：“It's green, baby”
修改拍攝方式	將相機運鏡改為順時針環繞人物拍攝，人物跟隨鏡頭移動。
修改拍攝方式	將視頻運鏡改為向上抬高並同時向下俯視。

複刻動作/運鏡/特效

複刻參考視頻的動作序列、運鏡軌跡與視覺特效，產生動態特徵一致的視頻。

類型	輸入提示詞或參考圖	輸入視頻	輸出視頻
複刻單人動作	讓圖片中的人物模仿視頻中的人的動作。
複刻多人動作	參考視頻五個人物動作，改為五個人在城市街道的路邊攤上唱歌彈琴。
複刻運鏡	參考原視頻運鏡方式，鏡頭快速移動，情境更改為在頒獎典禮上，參考圖片中的女人在走紅毯。
複刻特效	參考視頻的特效，將這個特效應用到圖片中女人身上，情境為街邊。

如何輸入視頻和映像

輸入視頻

視頻數量：必傳，有且僅有1個。
輸入方式：
- 公網URL：支援 HTTP 或 HTTPS 協議。樣本：https://xxxx/xxx.mp4。

輸入參考映像

映像數量：可選，最多4張。

輸入方式：

公網URL：支援 HTTP 或 HTTPS 協議。樣本：https://xxxx/xxx.png。

Base 64 編碼字串：樣本：data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAABDg......（樣本已截斷，僅做示範）。

格式：data:{MIME_type};base64,{base64_data} ，其中：

{base64_data}：影像檔經過 Base 64 編碼後的字串。
{MIME_type}：映像的媒體類型，需與檔案格式對應。

映像格式	MIME Type
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)

輸出視頻

視頻數量：1個。
視頻規格：格式為MP4。具體請參見視頻規格範圍。
視頻URL有效期間：24小時。
視頻尺寸：由參數resolution指定視頻解析度，參數ratio指定視頻寬高比。

計費與限流

模型免費額度和計費單價請參見模型價格。
模型限流請參見萬相系列。
計費說明：
- 輸入映像不計費，輸入視頻和輸出視頻計費，按視頻秒數計費。即：總計費時間長度（秒）= 輸入視頻時間長度（秒）+ 輸出視頻時間長度（秒）。
- 模型調用失敗或處理錯誤不產生任何費用，也不消耗新人免費額度。

API文檔

萬相2.7-視頻編輯

常見問題

Q：視頻編輯2.7（wan2.7-videoedit）與視頻編輯2.1（wan2.1-vace-plus）有什麼區別？

A：視頻編輯2.7通過指令直接編輯視頻，使用簡單，能力全面升級。視頻編輯2.1需指定function參數，側重掩碼局部編輯、畫面擴充等功能。推薦優先選用視頻編輯 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>"}
    ]
}

​快速開始

​適用範圍

​核心能力

​純指令編輯

​指令+參考圖編輯

​使用情境及效果樣本

​添加/刪除/修改元素

​修改環境或背景

​修改視頻風格

​修改角色行為/台詞/拍攝方式

​複刻動作/運鏡/特效

​如何輸入視頻和映像

​輸入視頻

​輸入參考映像

​輸出視頻

​計費與限流

​API文檔

​常見問題

​Q：視頻編輯2.7（wan2.7-videoedit）與視頻編輯2.1（wan2.1-vace-plus）有什麼區別？

​Q：如何傳入多張參考映像？

快速開始

適用範圍

核心能力

純指令編輯

指令+參考圖編輯

使用情境及效果樣本

添加/刪除/修改元素

修改環境或背景

修改視頻風格

修改角色行為/台詞/拍攝方式

複刻動作/運鏡/特效

如何輸入視頻和映像

輸入視頻

輸入參考映像

輸出視頻

計費與限流

API文檔

常見問題

Q：視頻編輯2.7（wan2.7-videoedit）與視頻編輯2.1（wan2.1-vace-plus）有什麼區別？

Q：如何傳入多張參考映像？