爱诗-文生视频模型基于 文本提示词 ,生成一段流畅的视频。
服务开通
- 前往阿里云百炼控制台,搜索 PixVerse,找到 PixVerse 模型卡片,单击立即开通;
- 在弹窗内确认开通及授权。
适用范围
为确保调用成功,请务必保证模型、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 (必选)模型名称。可选值:
模型选型
object (必选)输入的基本信息,如提示词等。
属性 prompt string (必选)文本提示词。用来描述生成视频中期望包含的元素和视觉特点。支持中英文,每个汉字/字母占一个字符,字符编码为UTF-8,超过部分会自动截断。
object (必选)视频生成参数。如设置视频分辨率、时长、是否生成音频等。
属性 size string (必选)生成视频的分辨率,格式为宽*高的像素值。不同分辨率档位和宽高比对应的可选值见下方表格。
pixverse/pixverse-c1-t2v、pixverse/pixverse-v6-t2v模型
pixverse/pixverse-v5.6-t2v模型
integer (必选)生成视频的时长,单位为秒。
boolean (可选)是否生成有声视频。开启后模型将根据视频内容自动生成匹配的背景音乐或音效。
boolean (可选)是否添加水印标识,水印位于视频右下角,文案固定为“AI生成”。
string (可选)支持模型:pixverse/pixverse-v6-t2v。指定生成视频的镜头类型,控制视频是由一个连续镜头还是多镜头组成。
integer(可选)随机数种子,取值范围为[0, 2147483647]。未指定时,系统自动生成随机种子。若需提升生成结果的可复现性,建议固定seed值。请注意,由于模型生成具有概率性,即使使用相同 seed,也不能保证每次生成结果完全一致。 |
支持模型:pixverse/pixverse-c1-t2v、pixverse/pixverse-v6-t2v、pixverse/pixverse-v5.6-t2v。 |
响应参数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}
请求参数请求头(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 时返回。视频格式为MP4(H.264 编码)。视频链接暂无过期时间,但不建议将其作为长期存储,请及时下载。orig_prompt string原始输入的prompt,对应请求参数prompt。codestring请求失败的错误码。请求成功时不会返回此参数,详情请参见错误码。messagestring请求失败的详细信息。请求成功时不会返回此参数,详情请参见错误码。object输出信息统计。只对成功的结果计数。
属性 duration integer生成视频的总视频时长(秒),用于计费。size string生成视频的分辨率。fps integer生成视频的帧率。SR string生成视频的分辨率档位。audio boolean生成视频是否为有声视频。video_count integer生成视频的数量。固定为1。shot_typestring生成视频的镜头类型。string请求唯一标识。可用于请求明细溯源和问题排查。 |
|
DashScope SDK调用
SDK 的参数命名与HTTP接口基本一致,参数结构根据语言特性进行封装。
由于文生视频任务耗时较长(通常为1-5分钟),SDK 在底层封装了 HTTP 异步调用流程,支持同步、异步两种调用方式。
具体耗时受限于排队任务数和服务执行情况,请在获取结果时耐心等待。
Python SDK调用
北京地域:dashscope.base_http_api_url = 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1'
调用时请将{WorkspaceId}替换为真实的业务空间ID。
- 同步调用
- 异步调用
请求示例
响应示例
video_url暂无过期时间,但不建议将其作为长期存储,请及时下载。
Java SDK调用
北京地域:Constants.baseHttpApiUrl = "https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1";
调用时请将{WorkspaceId}替换为真实的业务空间ID。
- 同步调用
- 异步调用
请求示例
响应示例
video_url 暂无过期时间,但不建议将其作为长期存储,请及时下载。
错误码
如果模型调用失败并返回报错信息,请参见错误码进行解决。
常见问题
Q:为什么1080P分辨率下不能使用10秒时长?
A: pixverse-v5.6-t2v 在 1080P 下不支持 10 秒。建议降低分辨率至 720P/540P/360P,或切换至 pixverse-c1-t2v或pixverse-v6-t2v 模型。