通义万相-图生视频API参考

请求示例

import os
from http import HTTPStatus
# dashscope sdk >= 1.23.4
from dashscope import VideoSynthesis

# 从环境变量中获取 DashScope API Key（即阿里云百炼平台 API key）
api_key = os.getenv("DASHSCOPE_API_KEY")

# ========== 图像输入方式（二选一）==========
# 【方式一】使用公网图片 URL
img_url = "https://cdn.translate.alibaba.com/r/wanx-demo-1.png"

# 【方式二】使用本地文件路径（file://+文件路径）
# 使用绝对路径
# img_url = "file://" + "/path/to/your/img.png"    # Linux/macOS
# img_url = "file://" + "C:/path/to/your/img.png"  # Windows
# 或使用相对路径
# img_url = "file://" + "./img.png"                # 以实际路径为准

def sample_call_i2v():
    # call sync api, will return the result
    print('please wait...')
    rsp = VideoSynthesis.call(api_key=api_key,
                              model='wanx2.1-i2v-turbo',
                              prompt='一只猫在草地上奔跑',
                              img_url=img_url)
    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_call_i2v()

响应示例

video_url 有效期24小时，请及时下载视频。

{
    "status_code": 200,
    "request_id": "aead6248-1bb3-9506-8c72-xxxxxx",
    "code": null,
    "message": "",
    "output": {
        "task_id": "3bd8b12f-da4d-4882-badb-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/xxx.mp4?xxxxxx",
        "submit_time": "2025-02-12 10:35:47.260",
        "scheduled_time": "2025-02-12 10:35:48.304",
        "end_time": "2025-02-12 10:41:13.449",
        "orig_prompt": "一只猫在草地上奔跑",
        "actual_prompt": "一只猫在草地上奔跑运镜平稳，画面稳定，高清，特写，精美，专业视频"
    },
    "usage": {
        "video_count": 1,
        "video_duration": 5,
        "video_ratio": "standard"
    }
}

请求示例

import os
from http import HTTPStatus
# dashscope sdk >= 1.23.4
from dashscope import VideoSynthesis

# 从环境变量中获取 DashScope API Key（即阿里云百炼平台 API key）
api_key = os.getenv("DASHSCOPE_API_KEY")

# ========== 图像输入方式（二选一）==========
# 【方式一】使用公网图片 URL
img_url = "https://cdn.translate.alibaba.com/r/wanx-demo-1.png"

# 【方式二】使用本地文件路径（file://+文件路径）
# 使用绝对路径
# img_url = "file://" + "/path/to/your/img.png"    # Linux/macOS
# img_url = "file://" + "C:/path/to/your/img.png"  # Windows
# 或使用相对路径
# img_url = "file://" + "./img.png"                # 以实际路径为准

def sample_async_call_i2v():
    # call async api, will return the task information
    # you can get task status with the returned task id.
    rsp = VideoSynthesis.async_call(api_key=api_key,
                                    model='wanx2.1-i2v-turbo',
                                    prompt='一只猫在草地上奔跑',
                                    img_url=img_url)
    print(rsp)
    if rsp.status_code == HTTPStatus.OK:
        print("task_id: %s" % rsp.output.task_id)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))
    # get the task information include the task status.
    status = VideoSynthesis.fetch(rsp)
    if status.status_code == HTTPStatus.OK:
        print(status.output.task_status)  # check the task status
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (status.status_code, status.code, status.message))

    # wait the task complete, will call fetch interval, and check it's in finished status.
    rsp = VideoSynthesis.wait(rsp)
    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_async_call_i2v()

响应示例

1、创建任务的响应示例

{
    "status_code": 200,
    "request_id": "6dc3bf6c-be18-9268-9c27-xxxxxx",
    "code": "",
    "message": "",
    "output": {
        "task_id": "686391d9-7ecf-4290-a8e9-xxxxxx",
        "task_status": "PENDING",
        "video_url": ""
    },
    "usage": null
}

2、查询任务结果的响应示例

video_url 有效期24小时，请及时下载视频。

{
    "status_code": 200,
    "request_id": "c62edc62-5b7a-9d21-9d55-xxxxxx",
    "code": null,
    "message": "",
    "output": {
        "task_id": "686391d9-7ecf-4290-a8e9-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/xxx.mp4?xxxxxx",
        "submit_time": "2025-02-12 10:25:57.668",
        "scheduled_time": "2025-02-12 10:28:04.052",
        "end_time": "2025-02-12 10:32:43.580"
    },
    "usage": {
        "video_count": 1,
        "video_duration": 5,
        "video_ratio": "standard"
    }
}

请求示例

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

// dashscope sdk >= 2.20.1
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.JsonUtils;

import java.util.HashMap;
import java.util.Map;

public class Image2Video {

     // 从环境变量中获取 DashScope API Key（即阿里云百炼平台 API key）
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    /**
     * 图像输入方式（二选一）
     *
     * 【方式一】公网URL
     */
    static String imgUrl = "https://cdn.translate.alibaba.com/r/wanx-demo-1.png";

    /**
     * 【方式二】本地文件路径（file://+绝对路径 or file:///+绝对路径）
     */
    // static String imgUrl = "file://" + "/your/path/to/img.png";     // Linux/macOS
    // static String imgUrl = "file:///" + "C:/your/path/to/img.png";  // Windows

    public static void image2video() throws ApiException, NoApiKeyException, InputRequiredException {
        // 设置parameters参数
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("prompt_extend", true);

        VideoSynthesis vs = new VideoSynthesis();
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wanx2.1-i2v-turbo")
                        .prompt("一只猫在草地上奔跑")
                        .imgUrl(imgUrl)
                        .parameters(parameters)
                        .build();
        System.out.println("please wait...");
        VideoSynthesisResult result = vs.call(param);
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            image2video();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}

响应示例

video_url 有效期24小时，请及时下载视频。

{
    "request_id": "3171aa20-c479-9dc2-ae55-xxxxxx",
    "output": {
        "task_id": "8b61b356-45ad-45f3-9be2-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.mp4?xxxxxx"
    },
    "usage": {
        "video_count": 1,
        "video_duration": 5,
        "video_ratio": "standard"
    }
}

请求示例

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

// dashscope sdk >= 2.20.1
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.JsonUtils;

import java.util.HashMap;
import java.util.Map;

public class Image2Video {

    // 从环境变量中获取 DashScope API Key（即阿里云百炼平台 API key）
    static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    /**
     * 图像输入方式（二选一）
     *
     * 【方式一】公网URL
     */
    static String imgUrl = "https://cdn.translate.alibaba.com/r/wanx-demo-1.png";

    /**
     * 【方式二】本地文件路径（file://+绝对路径 or file:///+绝对路径）
     */
    // static String imgUrl = "file://" + "/your/path/to/img.png";     // Linux/macOS
    // static String imgUrl = "file:///" + "C:/your/path/to/img.png";  // Windows

    public static void image2video() throws ApiException, NoApiKeyException, InputRequiredException {
        // 设置parameters参数
        Map<String, Object> parameters = new HashMap<>();
        parameters.put("prompt_extend", true);

        VideoSynthesis vs = new VideoSynthesis();
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .apiKey(apiKey)
                        .model("wanx2.1-i2v-turbo")
                        .prompt("一只猫在草地上奔跑")
                        .imgUrl(imgUrl)
                        .parameters(parameters)
                        .build();
        // 异步调用
        VideoSynthesisResult task = vs.asyncCall(param);
        System.out.println(JsonUtils.toJson(task));
        System.out.println("please wait...");

        //获取结果
        VideoSynthesisResult result = vs.wait(task, apiKey);
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            image2video();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}

响应示例

1、创建任务的响应示例

{
    "request_id": "5dbf9dc5-4f4c-9605-85ea-xxxxxxxx",
    "output": {
        "task_id": "7277e20e-aa01-4709-xxxxxxxx",
        "task_status": "PENDING"
    }
}

2、查询任务结果的响应示例

video_url 有效期24小时，请及时下载视频。

{
    "request_id": "3d740fc4-a968-9c36-b0e7-xxxxxxxx",
    "output": {
        "task_id": "34dcf4b0-ed84-441e-91cb-xxxxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/xxx.mp4?xxxxxx"
    },
    "usage": {
        "video_count": 1,
        "video_duration": 5,
        "video_ratio": "standard"
    }
}