典名词元典名词元首页
API 文档三方工具教程
AI 模型接口视频万相

文生视频2.1-2.6

POST/api/v1/video/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

X-DashScope-Async*string

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

Request Body

application/json

model*string

模型名称,固定值:

wan2.5-t2v-preview

wan2.6-t2v

Value in"wan2.5-t2v-preview" | "wan2.6-t2v"
input*object

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

prompt*string

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

支持中英文,每个汉字/字母占一个字符,超过部分会自动截断。长度限制因模型版本而异:

wan2.6和wan2.5系列模型:不超过1500个字符

negative_prompt?string

反向提示词,用来描述不希望在视频画面中看到的内容,可以对视频画面进行限制。

支持中英文,长度不超过500个字符,超过部分会自动截断。

示例值:低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。

audio_url?string

支持模型:wan2.6和wan2.5系列模型。

音频文件的 URL,模型将使用该音频生成视频。

parameters*object

视频处理参数,如设置视频分辨率、设置视频时长、开启prompt智能改写、添加水印等。

resolution?string

指定生成的视频分辨率档位,用于调整视频的清晰度(总像素)。模型根据选择的分辨率档位,自动缩放至相近总像素,视频宽高比将尽量与输入图像 img_url 的宽高比保持一致

此参数的默认值和可用枚举值依赖于 model 参数,规则如下:

wan2.6-t2v :可选值:720P、1080P。默认值为1080P。

wan2.5-t2v-preview :可选值:480P、720P、1080P。默认值为1080P。

size?string

指定生成的视频分辨率,格式为宽*高。该参数的默认值和可用枚举值依赖于 model 参数,规则如下:

wan2.6-t2v:默认值为 1920*1080(1080P)。可选分辨率:720P、1080P对应的所有分辨率。

wan2.5-t2v-preview:默认值为 1920*1080(1080P)。可选分辨率:480P、720P、1080P对应的所有分辨率。

480P档位:可选的视频分辨率及其对应的视频宽高比为:

832*480:16:9。

480*832:9:16。

624*624:1:1。

720P档位:可选的视频分辨率及其对应的视频宽高比为:

1280*720:16:9。

720*1280:9:16。

960*960:1:1。

1088*832:4:3。

832*1088:3:4。

1080P档位:可选的视频分辨率及其对应的视频宽高比为:

1920*1080: 16:9。

1080*1920: 9:16。

1440*1440: 1:1。

1632*1248: 4:3。

1248*1632: 3:4。

duration?integer

生成视频的时长,单位为秒。该参数的取值依赖于 model参数:

wan2.6-t2v:取值为[2, 15]之间的整数。默认值为5。

wan2.5-t2v-preview:可选值为5、10。默认值为5。

prompt_extend?boolean

是否开启prompt智能改写。开启后使用大模型对输入prompt进行智能改写。对于较短的prompt生成效果提升明显,但会增加耗时。

true:默认值,开启智能改写。

false:不开启智能改写。

shot_type?string

支持模型:wan2.6系列模型。

指定生成视频的镜头类型,即视频是由一个连续镜头还是多个切换镜头组成。

生效条件:仅当"prompt_extend": true 时生效。

参数优先级:shot_type > prompt。例如,若 shot_type设置为"single",即使 prompt 中包含“生成多镜头视频”,模型仍会输出单镜头视频。

可选值:

single:默认值,输出单镜头视频。

multi:输出多镜头视频。

watermark?string

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

false:默认值,不添加水印。

true:添加水印。

seed?string

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

Response Body

application/json

curl -X POST "https://api.aa.com.cn/api/v1/video/generation" \  -H "Authorization: string" \  -H "X-DashScope-Async: string" \  -H "Content-Type: application/json" \  -d '{    "model": "wan2.5-t2v-preview",    "input": {      "prompt": "string",      "negative_prompt": "string",      "audio_url": "string"    },    "parameters": {      "resolution": "string",      "size": "string",      "duration": 0,      "prompt_extend": true,      "shot_type": "string",      "watermark": "string",      "seed": "string"    }  }'
{
  "code": 0,
  "data": {
    "urls": [
      "string"
    ],
    "usage": {
      "images": 0,
      "seconds": 0,
      "input_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0
    },
    "expired": "string",
    "task_id": "string",
    "task_status": "string"
  },
  "message": "string",
  "request_id": "string"
}