Vidu文生视频API参考-大模型服务平台百炼(Model Studio)-阿里云帮助中心

Vidu-文生视频模型基于文本提示词，生成一段流畅的视频。

重要

本文档仅适用于“中国内地（北京）”地域，且必须使用该地域的API Key。

服务开通

请前往阿里云百炼控制台，搜索 Vidu，找到 Vidu 模型卡片，单击立即开通；在弹窗内确认开通及授权。

适用范围

为确保调用成功，请务必保证模型、Endpoint URL 和 API Key 均属于同一地域。跨地域调用将会失败。

选择模型：确认模型所属的地域。
选择 URL：选择对应的地域 Endpoint URL，支持HTTP URL或 DashScope SDK URL。
配置 API Key：选择地域并获取API Key，再配置API Key到环境变量。
安装 SDK：如需通过SDK进行调用，请安装DashScope SDK。

HTTP调用

由于文生视频任务耗时较长（通常为1-5分钟），API采用异步调用。整个流程包含 "创建任务 -> 轮询获取" 两个核心步骤，具体如下：

步骤1：创建任务获取任务ID

北京地域：POST https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis

说明

创建成功后，使用接口返回的 task_id 查询结果，task_id 有效期为 24 小时。请勿重复创建任务，轮询获取即可。
新手指引请参见Postman。

请求参数

文生视频

curl --location 'https://dashscope.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": "vidu/viduq3-turbo_text2video",
    "input": {
        "prompt": "一只小猫在月光下奔跑"
    },
    "parameters": {
        "size": "960*528",
        "resolution": "540P",
        "duration": 5,
        "watermark": true
    }
}'

请求头（Headers）

Content-Type string （必选）

请求内容类型。此参数必须设置为application/json。

Content-Type string （必选）

请求内容类型。此参数必须设置为application/json。

X-DashScope-Async string （必选）

异步处理配置参数。HTTP请求只支持异步，必须设置为enable。

重要

缺少此请求头将报错：“current user api does not support synchronous calls”。

请求体（Request Body）

model string （必选）

模型名称。可选模型请参见模型列表。

示例值：vidu/viduq3-turbo_text2video。

input object （必选）

输入的基本信息，如提示词等。

属性

prompt string （必选）

文本提示词。用来描述生成视频中期望包含的元素和视觉特点。

支持中英文，每个汉字/字母占一个字符，字符长度不能超过 5000 个字符，超过部分会自动截断。

示例值：一只小猫在月光下奔跑。

parameters object （可选）

视频生成参数，如设置视频分辨率、时长等。

属性

resolution string （可选）

重要

resolution直接影响费用，请在调用前确认模型价格。

分辨率档位。可选值：

540P
720P：默认值。
1080P

size string （可选）

生成视频的分辨率，格式为宽*高的像素值。

默认值根据resolution而定：

当 resolution=540P 时，size 默认为 960*528。
当 resolution=720P 时，size 默认为 1280*720。
当 resolution=1080P 时，size 默认为 1920*1080。

不同分辨率档位及宽高比对应的可选值见下方表格。

分辨率档位	宽高比	size取值（宽*高）
540P	16:9	960*528
	9:16	528*960
	1:1	720*720
	4:3	816*608
	3:4	608*816
720P	16:9	1280*720
	9:16	720*1280
	1:1	960*960
	4:3	1104*816
	3:4	816*1104
1080P	16:9	1920*1080
	9:16	1080*1920
	1:1	1440*1440
	4:3	1674*1238
	3:4	1238*1674

duration integer（可选）

重要

duration直接影响费用，按秒计费，时间越长费用越高，请在调用前确认模型价格。

生成视频的时长，单位为秒。

vidu/viduq3-pro_text2video、vidu/viduq3-turbo_text2video：取值为[1, 16]之间的整数，默认值为5。
vidu/viduq2_text2video：取值为[1, 10]之间的整数，默认值为5。

audio boolean （可选）

支持模型：vidu/viduq3-pro_text2video、vidu/viduq3-turbo_text2video。

是否生成有声视频。开启后模型将根据视频内容自动生成匹配的背景音乐或音效。

false：默认值，输出无声视频。
true：输出有声视频。

watermark boolean （可选）

是否添加水印标识，水印位于视频右下角，文案固定为“内容由AI生成”。

false：默认值，不添加水印。
true：添加水印。

seed integer （可选）

随机数种子，取值范围为[0, 2147483647]。

未指定时，系统自动生成随机种子。若需提升生成结果的可复现性，建议固定seed值。

请注意，由于模型生成具有概率性，即使使用相同 seed，也不能保证每次生成结果完全一致。

示例值：12345。

响应参数	成功响应请保存 task_id，用于查询任务状态与结果。 `{ "output": { "task_status": "PENDING", "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx" }, "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx" }` 异常响应创建任务失败，请参见错误信息进行解决。 `{ "code": "InvalidApiKey", "message": "No API-key provided.", "request_id": "7438d53d-6eb8-4596-8835-xxxxxx" }`
output `object` 任务输出信息。属性 task_id `string` 任务ID。查询有效期24小时。 task_status `string` 任务状态。枚举值 PENDING：任务排队中 RUNNING：任务处理中 SUCCEEDED：任务执行成功 FAILED：任务执行失败 CANCELED：任务已取消 UNKNOWN：任务不存在或状态未知
request_id `string` 请求唯一标识。可用于请求明细溯源和问题排查。
code `string` 请求失败的错误码。请求成功时不会返回此参数，详情请参见错误信息。
message `string` 请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误信息。

步骤2：根据任务ID查询结果

北京地域：GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

说明

轮询建议：视频生成过程约需数分钟，建议采用轮询机制，并设置合理的查询间隔（如 15 秒）来获取结果。
任务状态流转：PENDING（排队中）→ RUNNING（处理中）→ SUCCEEDED（成功）/ FAILED（失败）。
task_id 有效期：24小时，超时后将无法查询结果，接口将返回任务状态为UNKNOWN。
RPS 限制：查询接口默认RPS为20。如需更高频查询或事件通知，建议配置异步任务回调。
更多操作：如需批量查询、取消任务等操作，请参见管理异步任务。

请求参数	查询任务结果将`{task_id}`完整替换为上一步接口返回的`task_id`的值。`task_id`查询有效期为24小时。 `curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \ --header "Authorization: Bearer $DASHSCOPE_API_KEY"`
请求头（Headers）
Authorization `string`（必选）请求身份认证。接口使用阿里云百炼API-Key进行身份认证。示例值：Bearer sk-xxxx。
URL路径参数（Path parameters）
task_id `string`（必选）任务ID。

响应参数	任务执行成功视频URL仅保留24小时，超时后会被自动清除，请及时保存生成的视频。 { "request_id": "eda50dad-a6d3-4e62-a70b-26bbb797ae81", "output": { "task_id": "d9254244-1f9b-4b4c-be82-d9560ba25708", "task_status": "SUCCEEDED", "submit_time": "2026-03-27 13:32:13.962", "scheduled_time": "2026-03-27 13:32:14.008", "end_time": "2026-03-27 13:32:43.375", "orig_prompt": "一只小猫在月光下奔跑", "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/xxx.mp4?xxx" }, "usage": { "duration": 5, "size": "960*528", "output_video_duration": 5, "fps": 24, "video_count": 1, "audio": false, "SR": "540" } } 任务执行失败若任务执行失败，task_status将置为 FAILED，并提供错误码和信息。请参见错误信息进行解决。 `{ "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d", "output": { "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010", "task_status": "FAILED", "code": "InvalidParameter", "message": "The size is not match xxxxxx" } }` 任务查询过期 task_id查询有效期为 24 小时，超时后将无法查询，返回以下报错信息。 `{ "request_id": "a4de7c32-7057-9f82-8581-xxxxxx", "output": { "task_id": "502a00b1-19d9-4839-a82f-xxxxxx", "task_status": "UNKNOWN" } }`
output `object` 任务输出信息。属性 task_id `string` 任务ID。查询有效期24小时。 task_status `string` 任务状态。枚举值 PENDING：任务排队中 RUNNING：任务处理中 SUCCEEDED：任务执行成功 FAILED：任务执行失败 CANCELED：任务已取消 UNKNOWN：任务不存在或状态未知轮询过程中的状态流转： PENDING（排队中） → RUNNING（处理中）→ SUCCEEDED（成功）/ FAILED（失败）。初次查询状态通常为 PENDING（排队中）或 RUNNING（处理中）。当状态变为 SUCCEEDED 时，响应中将包含生成的视频url。若状态为 FAILED，请检查错误信息并重试。 submit_time `string` 任务提交时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。 scheduled_time `string` 任务执行时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。 end_time `string` 任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。 end_time `string` 任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。 video_url `string` 视频URL。仅在 task_status 为 SUCCEEDED 时返回。视频格式为MP4（H.264 编码）。视频链接有效期24小时，请及时下载。 orig_prompt `string` 原始输入的prompt，对应请求参数`prompt`。 code `string` 请求失败的错误码。请求成功时不会返回此参数，详情请参见错误信息。 message `string` 请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误信息。
usage `object` 输出信息统计，只对成功的结果计数。属性 duration `integer` 总的视频计费时长（秒）。示例值：5。 output_video_duration `integer` 输出视频的时长（秒）。示例值：5。 size `string` 生成视频的分辨率。示例值：960528。 fps* `integer` 生成视频的帧率。示例值：24。 SR `string` 生成视频的分辨率档位。示例值：540。 audio `boolean` 生成视频是否为有声视频。示例值：false。 video_count `integer` 生成视频的数量。固定为1。
request_id `string` 请求唯一标识。可用于请求明细溯源和问题排查。

DashScope SDK调用

SDK 的参数命名与HTTP接口基本一致，参数结构根据语言特性进行封装。

由于文生视频任务耗时较长（通常为1-5分钟），SDK 在底层封装了 HTTP 异步调用流程，支持同步、异步两种调用方式。

具体耗时受限于排队任务数和服务执行情况，请在获取结果时耐心等待。

Python SDK调用

重要

请确保 DashScope Python SDK 版本不低于 1.25.8，再运行以下代码。

北京地域：dashscope.base_http_api_url = 'https://dashscope.aliyuncs.com/api/v1'

同步调用

请求示例

from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# 以下为北京地域URL
dashscope.base_http_api_url = 'https://dashscope.aliyuncs.com/api/v1'

# 若没有配置环境变量，请用百炼API Key将下行替换为：api_key="sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")

def sample_sync_call_t2v():
    # call sync api, will return the result
    print('please wait...')
    rsp = VideoSynthesis.call(api_key=api_key,
                              model='vidu/viduq3-turbo_text2video',
                              prompt='一只小猫在月光下奔跑',
                              size='960*528',
                              duration=5,
                              resolution='540P',
                              watermark=True)
    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_url24小时内有效，请及时下载。

{
    "status_code": 200,
    "request_id": "15bd86e5-28b1-40ad-a427-xxxxxx",
    "code": null,
    "message": "",
    "output": {
        "task_id": "a876c6ee-1c63-4d17-b6c0-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/xxx.mp4?xxx",
        "submit_time": "2026-03-27 13:35:49.508",
        "scheduled_time": "2026-03-27 13:35:49.540",
        "end_time": "2026-03-27 13:36:45.848",
        "orig_prompt": "一只小猫在月光下奔跑"
    },
    "usage": {
        "video_count": 1,
        "video_duration": 0,
        "video_ratio": "",
        "duration": 5,
        "size": "960*528",
        "output_video_duration": 5,
        "fps": 24,
        "audio": false,
        "SR": "540"
    }
}

异步调用

请求示例

from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# 以下为北京地域URL
dashscope.base_http_api_url = 'https://dashscope.aliyuncs.com/api/v1'

# 若没有配置环境变量，请用百炼API Key将下行替换为：api_key="sk-xxx"
api_key = os.getenv("DASHSCOPE_API_KEY")

def sample_async_call_t2v():
    # call async api, will return the task information
    rsp = VideoSynthesis.async_call(api_key=api_key,
                                    model='vidu/viduq3-turbo_text2video',
                                    prompt='一只小猫在月光下奔跑',
                                    size='960*528',
                                    duration=5,
                                    resolution='540P')
    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(task=rsp, api_key=api_key)
    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
    rsp = VideoSynthesis.wait(task=rsp, api_key=api_key)
    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": "15bd86e5-28b1-40ad-a427-xxxxxx",
    "code": null,
    "message": "",
    "output": {
        "task_id": "a876c6ee-1c63-4d17-b6c0-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/xxx.mp4?xxx",
        "submit_time": "2026-03-27 13:35:49.508",
        "scheduled_time": "2026-03-27 13:35:49.540",
        "end_time": "2026-03-27 13:36:45.848",
        "orig_prompt": "一只小猫在月光下奔跑"
    },
    "usage": {
        "video_count": 1,
        "video_duration": 0,
        "video_ratio": "",
        "duration": 5,
        "size": "960*528",
        "output_video_duration": 5,
        "fps": 24,
        "audio": false,
        "SR": "540"
    }
}

Java SDK调用

重要

请确保 DashScope Java SDK 版本不低于 2.22.6，再运行以下代码。

北京地域：Constants.baseHttpApiUrl = "https://dashscope.aliyuncs.com/api/v1";

同步调用

请求示例

// 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;
import com.alibaba.dashscope.utils.Constants;

public class Text2Video {

    static {
        // 以下为北京地域url
        Constants.baseHttpApiUrl = "https://dashscope.aliyuncs.com/api/v1";
    }

    // 若没有配置环境变量，请用百炼API Key将下行替换为：api_key="sk-xxx"
    public static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    /**
     * 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()
                        .apiKey(apiKey)
                        .model("vidu/viduq3-turbo_text2video")
                        .prompt("一只小猫在月光下奔跑")
                        .size("960*528")
                        .resolution("540P")
                        .duration(5)
                        .watermark(true)
                        .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": "bebc5f6b-a081-4b02-ad29-xxxxxx",
    "output": {
        "task_id": "2b0e287f-ebdc-49af-82aa-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/infer_92/xxx.mp4?xxx",
        "orig_prompt": "一只小猫在月光下奔跑",
        "submit_time": "2026-03-30 10:19:00.827",
        "scheduled_time": "2026-03-30 10:19:00.879",
        "end_time": "2026-03-30 10:19:28.172"
    },
    "usage": {
        "video_count": 1,
        "duration": 5.0,
        "size": "960*528",
        "input_video_duration": 0.0,
        "output_video_duration": 5.0,
        "SR": "540"
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

异步调用

请求示例

// 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;
import com.alibaba.dashscope.utils.Constants;

public class Text2Video {

    static {
        // 以下为北京地域url
        Constants.baseHttpApiUrl = "https://dashscope.aliyuncs.com/api/v1";
    }

    // 若没有配置环境变量，请用百炼API Key将下行替换为：api_key="sk-xxx"
    public static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    /**
     * 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()
                        .apiKey(apiKey)
                        .model("vidu/viduq3-turbo_text2video")
                        .prompt("一只小猫在月光下奔跑")
                        .size("960*528")
                        .resolution("540P")
                        .duration(5)
                        .watermark(true)
                        .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 {
            text2Video();
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}

响应示例

1、创建任务的响应示例。

{
    "request_id": "9b583f1b-2423-4fac-bb3f-xxxxxx",
    "output": {
        "task_id": "3944b819-1bbb-4da0-a230-xxxxxx",
        "task_status": "PENDING"
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

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

video_url 24小时内有效，请及时下载。

{
    "request_id": "bebc5f6b-a081-4b02-ad29-xxxxxx",
    "output": {
        "task_id": "2b0e287f-ebdc-49af-82aa-xxxxxx",
        "task_status": "SUCCEEDED",
        "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/infer_92/xxx.mp4?xxx",
        "orig_prompt": "一只小猫在月光下奔跑",
        "submit_time": "2026-03-30 10:19:00.827",
        "scheduled_time": "2026-03-30 10:19:00.879",
        "end_time": "2026-03-30 10:19:28.172"
    },
    "usage": {
        "video_count": 1,
        "duration": 5.0,
        "size": "960*528",
        "input_video_duration": 0.0,
        "output_video_duration": 5.0,
        "SR": "540"
    },
    "status_code": 200,
    "code": "",
    "message": ""
}

错误码

如果模型调用失败并返回报错信息，请参见错误信息进行解决。

常见问题

Q：size 与 resolution 必须同时传入吗？

A：不必。二者均为可选参数，但推荐同时传入。同时传入可精准控制生成视频的宽高比，具体参见size取值。

若不同时传入，系统将按以下两种场景处理：

仅传 size：size参数会被忽略，系统强制按默认的 resolution=720P 及其对应的size默认值（1280*720）处理。
例如：接口返回为size="1280*720", SR=720。
仅传 resolution：按指定分辨率档位及该档位对应的 16:9 比例输出。
例如：当resolution=540P时，接口返回 size="960*528", SR=540；当resolution=1080P时，接口返回 size="1920*1080", SR=1080。

响应参数	任务执行成功视频URL仅保留24小时，超时后会被自动清除，请及时保存生成的视频。 { "request_id": "eda50dad-a6d3-4e62-a70b-26bbb797ae81", "output": { "task_id": "d9254244-1f9b-4b4c-be82-d9560ba25708", "task_status": "SUCCEEDED", "submit_time": "2026-03-27 13:32:13.962", "scheduled_time": "2026-03-27 13:32:14.008", "end_time": "2026-03-27 13:32:43.375", "orig_prompt": "一只小猫在月光下奔跑", "video_url": "https://prod-ss-vidu.s3.cn-northwest-1.amazonaws.com.cn/xxx.mp4?xxx" }, "usage": { "duration": 5, "size": "960*528", "output_video_duration": 5, "fps": 24, "video_count": 1, "audio": false, "SR": "540" } } 任务执行失败若任务执行失败，task_status将置为 FAILED，并提供错误码和信息。请参见错误信息进行解决。 `{ "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d", "output": { "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010", "task_status": "FAILED", "code": "InvalidParameter", "message": "The size is not match xxxxxx" } }` 任务查询过期 task_id查询有效期为 24 小时，超时后将无法查询，返回以下报错信息。 `{ "request_id": "a4de7c32-7057-9f82-8581-xxxxxx", "output": { "task_id": "502a00b1-19d9-4839-a82f-xxxxxx", "task_status": "UNKNOWN" } }`
output `object` 任务输出信息。属性 task_id `string` 任务ID。查询有效期24小时。 task_status `string` 任务状态。枚举值 PENDING：任务排队中 RUNNING：任务处理中 SUCCEEDED：任务执行成功 FAILED：任务执行失败 CANCELED：任务已取消 UNKNOWN：任务不存在或状态未知轮询过程中的状态流转： PENDING（排队中） → RUNNING（处理中）→ SUCCEEDED（成功）/ FAILED（失败）。初次查询状态通常为 PENDING（排队中）或 RUNNING（处理中）。当状态变为 SUCCEEDED 时，响应中将包含生成的视频url。若状态为 FAILED，请检查错误信息并重试。 submit_time `string` 任务提交时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。 scheduled_time `string` 任务执行时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。 end_time `string` 任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。 end_time `string` 任务完成时间。格式为 YYYY-MM-DD HH:mm:ss.SSS。 video_url `string` 视频URL。仅在 task_status 为 SUCCEEDED 时返回。视频格式为MP4（H.264 编码）。视频链接有效期24小时，请及时下载。 orig_prompt `string` 原始输入的prompt，对应请求参数`prompt`。 code `string` 请求失败的错误码。请求成功时不会返回此参数，详情请参见错误信息。 message `string` 请求失败的详细信息。请求成功时不会返回此参数，详情请参见错误信息。
usage `object` 输出信息统计，只对成功的结果计数。属性 duration `integer` 总的视频计费时长（秒）。示例值：5。 output_video_duration `integer` 输出视频的时长（秒）。示例值：5。 size `string` 生成视频的分辨率。示例值：960528。 fps* `integer` 生成视频的帧率。示例值：24。 SR `string` 生成视频的分辨率档位。示例值：540。 audio `boolean` 生成视频是否为有声视频。示例值：false。 video_count `integer` 生成视频的数量。固定为1。
request_id `string` 请求唯一标识。可用于请求明细溯源和问题排查。

服务开通

适用范围

HTTP调用

步骤1：创建任务获取任务ID

请求参数

文生视频

请求头（Headers）

请求体（Request Body）

响应参数

成功响应

异常响应

步骤2：根据任务ID查询结果

请求参数

查询任务结果

请求头（Headers）

URL路径参数（Path parameters）

响应参数

任务执行成功

任务执行失败

任务查询过期

DashScope SDK调用

Python SDK调用

同步调用

请求示例

响应示例

异步调用

请求示例

响应示例

Java SDK调用

同步调用

请求示例

响应示例

异步调用

请求示例

响应示例

错误码

常见问题

Q：size 与 resolution 必须同时传入吗？