参考生视频2.7
/api/v1/video/generationHeader Parameters
格式: Authorization: Bearer sk-xxxxxx
异步处理配置参数。HTTP请求只支持异步，必须设置为enable。
Request Body
application/json
模型名称，固定值：
wan2.7-r2v
"wan2.7-r2v"输入的基本信息，如提示词等。
文本提示词。用来描述生成视频中期望包含的元素和视觉特点。
支持中英文，每个汉字、字母、标点占一个字符，超过部分会自动截断。
wan2.7-r2v：不超过5000个字符。
参考指代：当为中文提示词时，参考图片时通过“图1、图2”这类标识指代，参考视频时通过“视频1、视频2”这类标识指代。英文提示词则写为“Image 1”、"Video 1”这类标识。英文字母和数字之间有空格，首字母大写。顺序与media数组顺序一致。图和视频分别计数，即同时存在图1、视频1等标识。若参考素材有且仅有一张图片或一个视频，则可简化表述为”参考图片”或“参考视频”。
画面描述：假设参考图1是一只猫，图2是一个房间，要描述猫在房间里玩耍，支持两种写法：一种是直接使用标识指代（如“图1在图2里玩耍”）；另一种是结合主体与场景补充说明（如“图1的猫在图2的房间里玩耍”）。
当参考图片为多宫格（故事板图像）时，提示词建议按照多分镜的形式描述画面内容。无需描述每个宫格，提供关键分镜内容即可，模型将自动识别宫格逻辑并智能补全镜头内容。为达到更好的效果，建议单次仅输入一张多宫格图。
反向提示词，用来描述不希望在视频画面中看到的内容，可以对视频画面进行限制。
支持中英文，长度不超过500个字符，超过部分会自动截断。
示例值：低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。
媒体素材数组，素材包括图像、视频和音频。支持图像/视频输入作为视觉参考，图像支持多视图，常见参考角色、道具、场景等。
数组中每个元素为一个媒体对象，包含 type 与 url 字段。
按照数组顺序定义prompt中角色引用的顺序。图和视频分别计数，即可同时存在图1、视频1。
数组中的第 1 个reference_video 对应 视频1，第 2 个对应 视频2，以此类推。
数组中的第 1 个reference_image对应 图1，第 2 个对应 图2，以此类推。
媒体素材类型。可选值为：
reference_image：参考图像。提供主体角色（人物/动物/物体）和场景参考。
reference_video：参考视频。提供主体角色（人物/动物/物体）和音色参考，不推荐传入空镜视频。
first_frame：首帧图像。基于首帧生成视频，通常包含主体角色（人物/动物/物体）。支持同时传入首帧图联合控制，常见用法如下：
首帧中已经出现待参考主体：此时可以搭配主体参考强化一致性，或进行音色参考。
首帧中未出现待参考主体：此时可以用主体参考来定义视频动态过程中新出现的主体特征。
素材限制：
首帧图像，最多传入1张。
参考图像和参考视频至少传入1个，参考图像 + 参考视频 ≤ 5。
参考素材为主体角色时，仅包含单一角色。
音频 URL。用于指定参考素材（图像/视频）中主体角色的音色。与reference_image或reference_video搭配使用。该音频仅参考音色，与说话内容无关。建议参考音频语种与提示词语种保持一致，匹配效果更佳。
音频生效逻辑：
默认行为：若 reference_video 本身包含音频，但未指定 reference_voice，默认使用视频原声。
优先级：若同时传入 reference_video（含音频）和 reference_voice，则优先使用 reference_voice 的音色，覆盖视频原声。
音频限制：
格式：wav、mp3。
时长：1～10s。
文件大小：不超过15MB。
视频处理参数，如设置视频分辨率、设置视频时长、开启prompt智能改写、添加水印等。
生成视频的分辨率档位，用于控制视频的清晰度（总像素）。
wan2.7-r2v：可选值：720P、1080P。默认值为1080P。
生成视频的宽高比。
生效逻辑：
未传入首帧图像：按指定的 ratio 参数生成视频。
已传入首帧图像：自动忽略 ratio 参数，以首帧图像的宽高比生成近似比例的视频。
可选值为：
16:9（默认值）
9:16
1:1
4:3
3:4
不同宽高比对应的输出视频分辨率（宽高像素值）见下方表格。
生成视频的时长，单位为秒。
wan2.7-r2v：默认值为5。
当参考素材中包含视频时：取值为[2, 10]之间的整数。
当参考素材中不包含视频时：取值为[2, 15]之间的整数。
是否开启prompt智能改写。开启后使用大模型对输入prompt进行智能改写。对于较短的prompt生成效果提升明显，但会增加耗时。
true：默认值，开启智能改写。
false：不开启智能改写。
是否添加水印标识，水印位于视频右下角，文案固定为“AI生成”。
false：默认值，不添加水印。
true：添加水印。
随机数种子，取值范围为[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.7-r2v", "input": { "prompt": "string", "negative_prompt": "string", "media": [ { "type": "string", "url": "string" } ] }, "parameters": { "resolution": "string", "ratio": "string", "duration": 0, "prompt_extend": true, "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"
}