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

请求示例

from http import HTTPStatus
# dashscope sdk >= 1.22.1
from dashscope import VideoSynthesis

def sample_sync_call_t2v():
    # call sync api, will return the result
    print('please wait...')
    rsp = VideoSynthesis.call(model='wan2.2-t2v-plus',
                              prompt='一只小猫在月光下奔跑',
                              size='1920*1080')
    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_t2v()

响应示例

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

{
	"status_code": 200,
	"request_id": "a250655b-c899-9384-b12e-xxxxxx",
	"code": null,
	"message": "",
	"output": {
		"task_id": "04d3cdfb-8405-4e6b-bb03-xxxxxx",
		"task_status": "SUCCEEDED",
		"video_url": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/aaa.mp4?Expires=xxx",
		"submit_time": "2025-02-12 11:27:12.975",
		"scheduled_time": "2025-02-12 11:29:39.988",
		"end_time": "2025-02-12 11:35:35.801",
		"orig_prompt": "一只小猫在月光下奔跑", 
		"actual_prompt": "水墨国风水墨动画，一只毛茸茸的白色小猫在月光下的庭院中奔跑。小猫圆眼睛，耳朵轻抖，四肢灵活，尾巴随跑动自然摆动。背景是古色古香的中式庭院，石板路两侧有低矮竹篱和盛开的梅花，远处是朦胧的月亮与夜空。画面带有淡淡蓝灰色调，营造出静谧夜晚氛围。镜头跟随小猫低角度运动拍摄，突出动态效果。"	
	},
	"usage": {
		"video_count": 1,
		"video_duration": 5,
		"video_ratio": "1920*1080"
	}
}

请求示例

from http import HTTPStatus
# dashscope sdk >= 1.22.1
from dashscope import VideoSynthesis

def sample_async_call_t2v():
    # call async api, will return the task information
    # you can get task status with the returned task id.
    rsp = VideoSynthesis.async_call(model='wan2.2-t2v-plus',
                                    prompt='一只小猫在月光下奔跑',
                                    size='1920*1080')
    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_t2v()

响应示例

1、创建任务的响应示例

{
	"status_code": 200,
	"request_id": "c86ff7ba-8377-917a-90ed-xxxxxx",
	"code": "",
	"message": "",
	"output": {
		"task_id": "721164c6-8619-4a35-a6d9-xxxxxx",
		"task_status": "PENDING",
		"video_url": ""
	},
	"usage": null
}

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

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

{
	"status_code": 200,
	"request_id": "efa545b3-f95c-9e3a-a3b6-xxxxxx",
	"code": null,
	"message": "",
	"output": {
		"task_id": "721164c6-8619-4a35-a6d9-xxxxxx",
		"task_status": "SUCCEEDED",
		"video_url": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/aaaa.mp4?Expires=xxx",
		"submit_time": "2025-02-12 11:03:30.701",
		"scheduled_time": "2025-02-12 11:06:05.378",
		"end_time": "2025-02-12 11:12:18.853",
		"orig_prompt": "一只小猫在月光下奔跑", 
		"actual_prompt": "水墨国风水墨动画，一只毛茸茸的白色小猫在月光下的庭院中奔跑。小猫圆眼睛，耳朵轻抖，四肢灵活，尾巴随跑动自然摆动。背景是古色古香的中式庭院，石板路两侧有低矮竹篱和盛开的梅花，远处是朦胧的月亮与夜空。画面带有淡淡蓝灰色调，营造出静谧夜晚氛围。镜头跟随小猫低角度运动拍摄，突出动态效果。"
	},
	"usage": {
		"video_count": 1,
		"video_duration": 5,
		"video_ratio": "1920*1080"
	}
}

请求示例

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

// dashscope sdk >= 2.18.2
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;

public class Text2Video {
    /**
     * Create a video compositing task and wait for the task to complete.
     */
    public static void text2Video() throws ApiException, NoApiKeyException, InputRequiredException {
        VideoSynthesis vs = new VideoSynthesis();
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .model("wan2.2-t2v-plus")
                        .prompt("一只小猫在月光下奔跑")
                        .size("1920*1080")
                        .build();
        System.out.println("please wait...");
        VideoSynthesisResult result = vs.call(param);
        System.out.println(JsonUtils.toJson(result));
    }

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

响应示例

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

{
	"request_id": "db27ee62-1148-9de4-aab9-xxxxxx",
	"output": {
		"task_id": "31c13f64-60e3-4822-b255-xxxxxx",
		"task_status": "SUCCEEDED",
		"video_url": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/aaa.mp4?Expires=xxx"
	},
	"usage": {
		"video_count": 1,
		"video_duration": 5,
		"video_ratio": "1920*1080"
	}
}

请求示例

// 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.JsonUtils;

public class Text2Video {
    /**
     * Create a video compositing task and wait for the task to complete.
     */
    public static void text2Video() throws ApiException, NoApiKeyException, InputRequiredException {
        VideoSynthesis vs = new VideoSynthesis();
        VideoSynthesisParam param =
                VideoSynthesisParam.builder()
                        .model("wan2.2-t2v-plus")
                        .prompt("一只小猫在月光下奔跑")
                        .size("1920*1080")
                        .build();

        // 异步调用
        VideoSynthesisResult task = vs.asyncCall(param);
        System.out.println(JsonUtils.toJson(task));
        System.out.println("please wait...");

        //获取结果
        // apiKey 已经配置在环境变量，因此这里可以设置为 null
        VideoSynthesisResult result = vs.wait(task, null);
        System.out.println(JsonUtils.toJson(result));
    }

    public static void main(String[] args) {
        try {
            text2Video();
        } 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": "1625235c-c13e-93ec-aff7-xxxxxxxx",
	"output": {
		"task_id": "464a5e46-79a6-46fd-9823-xxxxxxxx",
		"task_status": "SUCCEEDED",
		"video_url": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/aaa.mp4?Expires=xxx"
	},
	"usage": {
		"video_count": 1,
		"video_duration": 5,
		"video_ratio": "1920*1080"
	}
}