万相2.6-参考生视频模型支持 多模态输入 ,可将人或物体作为主角,生成单角色表演或多角色互动视频。
相关文档:使用指南
为确保调用成功,请务必保证模型、Endpoint URL 和 API Key 均属于同一地域。跨地域调用将会失败。
由于视频生成任务耗时较长(通常为1-5分钟),API采用异步调用。整个流程包含 “创建任务 -> 轮询获取” 两个核心步骤,具体如下:
SDK 的参数命名与HTTP接口基本一致,参数结构根据语言特性进行封装。
由于参考生视频任务耗时较长(通常为1-5分钟),SDK 在底层封装了 HTTP 异步调用流程,支持同步、异步两种调用方式。
根据模型所在地域设置
根据模型所在地域设置
如果模型调用失败并返回报错信息,请参见错误码进行解决。
适用范围
为确保调用成功,请务必保证模型、Endpoint URL 和 API Key 均属于同一地域。跨地域调用将会失败。
- 选择模型:确认模型所属的地域。
- 选择 URL:选择对应的地域 Endpoint URL,支持HTTP URL。
- 配置 API Key:选择地域并获取与配置 API Key,再配置API Key到环境变量。
本文的示例代码适用于北京地域。
HTTP调用
由于视频生成任务耗时较长(通常为1-5分钟),API采用异步调用。整个流程包含 “创建任务 -> 轮询获取” 两个核心步骤,具体如下:
步骤1:创建任务获取任务ID
- 北京
- 新加坡
- 弗吉尼亚
- 法兰克福
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis调用时请将{WorkspaceId}替换为真实的业务空间ID。- 创建成功后,使用接口返回的
task_id查询结果,task_id 有效期为 24 小时。请勿重复创建任务,轮询获取即可。 - 新手指引请参见Postman。
请求参数请求头(Headers)Content-Typestring(必选)请求内容类型。此参数必须设置为application/json。Authorizationstring(必选)请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值:Bearer sk-xxxx。X-DashScope-Asyncstring(必选)异步处理配置参数。HTTP请求只支持异步,必须设置为enable。请求体(Request Body)modelstring (必选)模型名称。模型列表与价格详见模型价格。示例值:wan2.6-r2v-flash。input object (必选)输入的基本信息,如提示词等。
属性 prompt string (必选)文本提示词。用来描述生成视频中期望包含的元素和视觉特点。支持中英文,每个汉字、字母、标点占一个字符,超过部分会自动截断。
string (可选)反向提示词,用来描述不希望在视频画面中出现的内容,可以对视频画面进行限制。支持中英文,长度不超过500个字符,超过部分会自动截断。示例值:低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。reference_urls array[string] (必选)上传的参考文件 URL 数组,支持传入视频和图像。用于提取角色形象与音色(如有),以生成符合参考特征的视频。
已废弃字段 reference_video_urls array[string]上传的参考视频文件 URL 数组。用于提取角色形象与音色(如有),以生成符合参考特征的视频。
object (可选)图像处理参数。如设置视频分辨率、开启prompt智能改写、添加水印等。
属性 size string (可选)指定生成的视频分辨率,格式为宽*高。该参数的默认值和可用枚举值依赖于 model 参数,规则如下:
integer (可选)生成视频的时长,单位为秒。
string (可选)指定生成视频的镜头类型,即视频是由一个连续镜头还是多个切换镜头组成。参数优先级:shot_type > prompt。例如,若 shot_type设置为"single",即使 prompt 中包含“生成多镜头视频”,模型仍会输出单镜头视频。可选值:
当希望严格控制视频的叙事结构(如产品展示用单镜头、故事短片用多镜头),可通过此参数指定。 boolean (可选)支持模型:wan2.6-r2v-flash。是否生成有声视频。可选值:
boolean (可选)是否添加水印标识,水印位于视频右下角,文案固定为“AI生成”。
integer(可选)随机数种子,取值范围为[0, 2147483647]。未指定时,系统自动生成随机种子。若需提升生成结果的可复现性,建议固定seed值。请注意,由于模型生成具有概率性,即使使用相同 seed,也不能保证每次生成结果完全一致。 |
通过 reference_urls传入图像和视频URL。同时设置shot_type为multi,生成多镜头视频。 |
响应参数outputobject任务输出信息。
属性 task_id string任务ID。查询有效期24小时。task_status string任务状态。
枚举值
string请求唯一标识。可用于请求明细溯源和问题排查。codestring请求失败的错误码。请求成功时不会返回此参数,详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误码。 |
请保存 task_id,用于查询任务状态与结果。 |
步骤2:根据任务ID查询结果
- 北京
- 新加坡
- 弗吉尼亚
- 法兰克福
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}调用时请将{WorkspaceId}替换为真实的业务空间ID。请求参数请求头(Headers)Authorizationstring(必选)请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值:Bearer sk-xxxx。URL路径参数(Path parameters)task_idstring(必选)任务ID。 |
将 {task_id}完整替换为上一步接口返回的task_id的值。task_id查询有效期为24小时,并请将{WorkspaceId}替换为真实的业务空间ID。 |
响应参数outputobject任务输出信息。
属性 task_id string(必选)任务ID。task_status string任务状态。
枚举值
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。video_urlstring视频URL。仅在 task_status 为 SUCCEEDED 时返回。链接有效期24小时,可通过此URL下载视频。视频格式为MP4(H.264 编码)。orig_prompt string原始输入的prompt,对应请求参数prompt。codestring请求失败的错误码。请求成功时不会返回此参数,详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误码。object输出信息统计。只对成功的结果计数。
属性 input_video_duration integer输入的参考视频的时长,单位秒。output_video_duration integer输出视频的时长,单位秒。duration float总视频时长。计费按duration时长计算。计算公式:duration = input_video_duration + output_video_duration。SR integer生成视频的分辨率档位。示例值:720。sizestring生成视频的分辨率。格式为“宽高”,示例值:1280720。video_count integer生成视频的数量。固定为1。string请求唯一标识。可用于请求明细溯源和问题排查。 |
视频URL仅保留24小时,超时后会被自动清除,请及时保存生成的视频。 |
DashScope SDK调用
SDK 的参数命名与HTTP接口基本一致,参数结构根据语言特性进行封装。
由于参考生视频任务耗时较长(通常为1-5分钟),SDK 在底层封装了 HTTP 异步调用流程,支持同步、异步两种调用方式。
具体耗时受限于排队任务数和服务执行情况,请在获取结果时耐心等待。
Python SDK调用
根据模型所在地域设置 base_http_api_url:
- 北京
- 新加坡
- 美国
- 法兰克福
dashscope.base_http_api_url = 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1'调用时请将{WorkspaceId}替换为真实的业务空间ID。- 同步调用
- 异步调用
同步调用会阻塞等待,直到视频生成完成并返回结果。
请求示例
Java SDK调用
根据模型所在地域设置 baseHttpApiUrl:
- 北京
- 新加坡
- 法兰克福
Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1";调用时请将{WorkspaceId}替换为真实的业务空间ID。- 同步调用
- 异步调用
同步调用会阻塞等待,直到视频生成完成并返回结果。