Vidu — 创建任务

POST

/services/aigc/video-generation/video-synthesis

cURL

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
  }
}'

{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  },
  "code": "<string>",
  "message": "<string>"
}

提交文生视频任务后，服务将异步生成视频。提交任务后，使用查询视频结果接口轮询任务状态，直到 task_status 为 SUCCEEDED 或 FAILED。

模型列表

模型	最高分辨率	最长时长
`vidu/viduq3-turbo_text2video`	1080P	16 秒
`vidu/viduq3-pro_text2video`	1080P	16 秒
`vidu/viduq2_text2video`	1080P	10 秒

HTTP 调用

文生视频接口仅支持异步调用，请求时必须携带请求头 X-DashScope-Async: enable。任务提交成功后返回 task_id，使用查询视频结果接口获取生成结果。

size 参数取值对照表

size 参数与 resolution 参数共同控制输出视频的尺寸。两者均传入时以 size 为准。

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

size 与 resolution 均不传时，默认输出 720P 16:9（1280*720）。

DashScope SDK 调用

使用 SDK 调用时，需安装对应版本的 DashScope SDK：

Python SDK：版本 >= 1.25.8
Java SDK：版本 >= 2.22.6

安装方法参见安装 DashScope SDK。

Python SDK

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

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():
  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()

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

public class Text2Video {
    static {
        Constants.baseHttpApiUrl = "https://dashscope.aliyuncs.com/api/v1";
    }
    public static String apiKey = System.getenv("DASHSCOPE_API_KEY");

    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);
    }
}

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

enum<string>

必填

请求内容类型，必须设置为 application/json。

可选值：application/json

enum<string>

必填

异步处理配置参数。HTTP 请求只支持异步，必须设置为 enable。缺少此请求头将报错："current user api does not support synchronous calls"。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称。

可选值：vidu/viduq3-turbo_text2video,vidu/viduq3-pro_text2video,vidu/viduq2_text2video

示例:vidu/viduq3-turbo_text2video

object

必填

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

显示子属性

string

必填

文本提示词。用来描述生成视频中期望包含的元素和视觉特点。支持中英文，每个汉字/字母占一个字符，不能超过 5000 个字符，超过部分会自动截断。示例值：一只小猫在月光下奔跑。

提示词编写请参见Vidu视频生成Prompt指南。

示例:一只小猫在月光下奔跑

object

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

显示子属性

enum<string>

默认值"720P"

分辨率档位。resolution 直接影响费用，请在调用前确认模型价格。

可选值：540P,720P,1080P

示例:720P

string

生成视频的分辨率，格式为宽高的像素值。默认值根据 resolution 而定：resolution=540P 时默认为 960528，resolution=720P 时默认为 1280720，resolution=1080P 时默认为 19201080。

integer

默认值5

生成视频的时长，单位为秒。duration 直接影响费用，按秒计费，时间越长费用越高。vidu/viduq3-pro_text2video 和 vidu/viduq3-turbo_text2video：取值为 [1, 16] 之间的整数，默认值为 5。vidu/viduq2_text2video：取值为 [1, 10] 之间的整数，默认值为 5。

示例:5

boolean

默认值false

是否生成有声视频。开启后模型将根据视频内容自动生成匹配的背景音乐或音效。支持模型：vidu/viduq3-pro_text2video、vidu/viduq3-turbo_text2video。

示例:false

boolean

默认值false

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

示例:false

integer

随机数种子，取值范围为 [0, 2147483647]。未指定时系统自动生成随机种子。若需提升生成结果的可复现性，建议固定 seed 值。由于模型生成具有概率性，即使使用相同 seed，也不能保证每次生成结果完全一致。示例值：12345。

示例:12345

取值范围：0 <= x <= 2147483647

响应

200-application/json

string

请求唯一标识。可用于请求明细溯源和问题排查。

示例:4909100c-7b5a-9f92-bfe5-xxxxxx

object

任务输出信息。

显示子属性

string

任务 ID。用于查询任务状态与结果，有效期 24 小时。

示例:0385dc79-5ff8-4d82-bcb6-xxxxxx

enum<string>

任务状态。初始状态通常为 PENDING。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

示例:PENDING

string

请求失败的错误码。请求成功时不会返回此参数。

string

请求失败的详细信息。请求成功时不会返回此参数。

​模型列表

​HTTP 调用

​size 参数取值对照表

​DashScope SDK 调用

​Python SDK

​Java SDK

鉴权

Header 参数

请求体

响应

模型列表

HTTP 调用

size 参数取值对照表

DashScope SDK 调用

Python SDK

Java SDK