万相-文生视频模型基于 文本提示词 ,生成一段流畅的视频。
相关文档:使用指南
为确保调用成功,请务必保证模型、Endpoint URL 和 API Key 均属于同一地域。跨地域调用将会失败。
由于文生视频任务耗时较长(通常为1-5分钟),API采用异步调用。整个流程包含 “创建任务 -> 轮询获取” 两个核心步骤,具体如下:
SDK 的参数命名与HTTP接口基本一致,参数结构根据语言特性进行封装。
由于文生视频任务耗时较长(通常为1-5分钟),SDK 在底层封装了 HTTP 异步调用流程,支持同步、异步两种调用方式。
根据模型所在地域设置
根据模型所在地域设置
如果模型调用失败并返回报错信息,请参见错误码进行解决。
A: 不能直接转换该链接。正确的做法是:后端服务获取到url后,通过代码下载该视频文件,然后将其上传到永久对象存储服务(如阿里云 OSS),生成一个新的、永久访问链接。
A: 不建议这样做,因为链接会在 24 小时后失效。最佳实践是后端下载转存后,使用永久链接进行视频播放。
适用范围
为确保调用成功,请务必保证模型、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://{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-t2v。input object (必选)输入的基本信息,如提示词等。
属性 prompt string (必选)文本提示词。用来描述生成视频中期望包含的元素和视觉特点。支持中英文,每个汉字/字母占一个字符,超过部分会自动截断。长度限制因模型版本而异:
string (可选)反向提示词,用来描述不希望在视频画面中看到的内容,可以对视频画面进行限制。支持中英文,长度不超过500个字符,超过部分会自动截断。示例值:低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。audio_url string (可选)支持模型:wan2.6和wan2.5系列模型。音频文件URL,模型将使用该音频生成视频。支持输入的格式:
object (可选)图像处理参数。如设置视频分辨率、开启prompt智能改写、添加水印等。
属性 size string (可选)指定生成的视频分辨率,格式为宽*高。该参数的默认值和可用枚举值依赖于 model 参数,规则如下:
integer (可选)生成视频的时长,单位为秒。该参数的取值依赖于 model参数:
boolean (可选)是否开启prompt智能改写。开启后使用大模型对输入prompt进行智能改写。对于较短的prompt生成效果提升明显,但会增加耗时。
string (可选)支持模型:wan2.6模型。指定生成视频的镜头类型,即视频是由一个连续镜头还是多个切换镜头组成。可选值:
"prompt_extend": true 时生效。参数优先级:shot_type > prompt。例如,若 shot_type设置为"single",即使 prompt 中包含“生成多镜头视频”,模型仍会输出单镜头视频。watermark boolean (可选)是否添加水印标识,水印位于视频右下角,文案固定为“AI生成”。
integer(可选)随机数种子,取值范围为[0, 2147483647]。未指定时,系统自动生成随机种子。若需提升生成结果的可复现性,建议固定seed值。请注意,由于模型生成具有概率性,即使使用相同 seed,也不能保证每次生成结果完全一致。 |
|
响应参数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。查询有效期24小时。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。actual_prompt string当 prompt_extend=true 时,系统会对输入 prompt 进行智能改写,此字段返回实际用于生成的优化后 prompt。
string请求失败的错误码。请求成功时不会返回此参数,详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误码。object输出信息统计。只对成功的结果计数。
属性 video_duration integer仅在使用 wan2.5 及以下版本模型时返回,用于计费。生成视频的时长,单位秒。枚举值为5、10。duration float仅在使用 wan2.6 模型时返回,用于计费。表示总的视频时长,且duration=input_video_duration+output_video_duration。input_video_duration integer仅在使用 wan2.6 模型时返回。固定为0。output_video_duration integer仅在使用 wan2.6 模型时返回。输出视频的时长,单位秒。其值等同于input.duration的值。SR integer仅在使用 wan2.6 模型时返回。生成视频的分辨率档位。示例值:720。size string仅在使用 wan2.6 模型时返回。生成视频的分辨率。格式为“宽高”,示例值:19201080。video_ratio string仅 wan2.5 及以下版本模型时返回。生成视频的分辨率。格式为“宽高”,示例值:832480。video_count integer生成视频的数量。固定为1。string请求唯一标识。可用于请求明细溯源和问题排查。 |
视频URL仅保留24小时,超时后会被自动清除,请及时保存生成的视频。 |
DashScope SDK调用
SDK 的参数命名与HTTP接口基本一致,参数结构根据语言特性进行封装。
由于文生视频任务耗时较长(通常为1-5分钟),SDK 在底层封装了 HTTP 异步调用流程,支持同步、异步两种调用方式。
具体耗时受限于排队任务数和服务执行情况,请在获取结果时耐心等待。
Python SDK调用
根据模型所在地域设置 dashscope.base_http_api_url:
- 北京
- 新加坡
- 弗吉尼亚
- 法兰克福
dashscope.base_http_api_url = 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1'调用时请将{WorkspaceId}替换为真实的业务空间ID。- 同步调用
- 异步调用
请求示例
响应示例
video_url 有效期24小时,请及时下载视频。
Java SDK调用
根据模型所在地域设置 Constants.baseHttpApiUrl:
- 北京
- 新加坡
- 弗吉尼亚
- 法兰克福
Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1";调用时请将{WorkspaceId}替换为真实的业务空间ID。- 同步调用
- 异步调用
请求示例
响应示例
video_url 有效期24小时,请及时下载视频。
错误码
如果模型调用失败并返回报错信息,请参见错误码进行解决。
常见问题
Q: 如何将临时的视频链接转为永久链接?
A: 不能直接转换该链接。正确的做法是:后端服务获取到url后,通过代码下载该视频文件,然后将其上传到永久对象存储服务(如阿里云 OSS),生成一个新的、永久访问链接。
示例代码:下载视频到本地
示例代码:下载视频到本地