# 参考生视频 基于参考图像和文本提示词生成视频。例如，以一张或者多张静态图片作为基础，通过模型根据这张图片的内容、风格或结构，生成一段动态视频。简单来说，就是让一张或者多张"静止的画"动起来，或者基于这张图的创意延伸出新的视频画面。MaaS支持模型以及相关参数，请参见[支持模型]。 #### 支持模型 表1三方模型 | model参数（模型 ID） | 支持能力 | 输入输出限制 | 默认限流 | |:---|:---|:---|:---| | pixverse/pixverse-v6-r2v | 参考生视频 | 输入类型：文本+图片 最大输入限制：文本 5000 字符；图片 50 MB（Base64编码）。 输出视频格式：MP4 输出视频帧率（fps）：24 输出视频时长：1s～15s，可选。 | RPM: 30 | | vidu/viduq3-turbo_reference2video | 参考生视频 | 输入类型：文本+图片 最大输入限制：文本 5000 字符；图片 50 MB（Base64编码）。 输出视频格式：MP4 输出视频帧率（fps）：24 输出视频最高分辨率：1080p 输出视频时长：1s～16s，可选。 | RPM: 30 | | vidu/viduq3-mix_reference2video | 参考生成视频 | 输入类型：文本+图片 最大输入限制：文本 5000 字符；图片 50 MB（Base64编码）。 输出视频格式：MP4 输出视频帧率（fps）：24 输出视频最高分辨率：1080p 输出视频时长：1s～15s，可选。 | RPM: 30 | | vidu/viduq3-ad_reference2video | 参考生成视频 | 输入类型：文本+图片 最大输入限制：文本 5000 字符；图片 50 MB（Base64编码）。 输出视频格式：MP4 输出视频帧率（fps）：24 输出视频最高分辨率：1080p 输出视频时长：1s～15s，可选。 | RPM: 30 | #### 前提条件 - 已在"模型推理 \> 在线推理 \> 预置服务"页签开通预置服务。详情请见[开通MaaS预置服务](https://support.huaweicloud.com/model-call-maas/model-call-052.html)。 - 已获取API Key。详情请见[在MaaS管理API Key](https://support.huaweicloud.com/model-call-maas/model-call-049.html)。 - 已获取模型服务的model参数值。详情请见[支持模型]。 #### 使用限制 - 任务数据（如任务状态、视频URL等）仅保留24小时，超时后会被自动清除。请您务必及时保存生成的视频。 - 不同模型的限制值不同，具体限制值请以MaaS控制台"在线推理\>预置服务"页面的模型限流列为准。 - TPM：每分钟处理的Tokens数（输入+输出）。 - RPM：每分钟处理的请求数。 - 目前三方服务仅支持个人用户开通。 #### API说明 模型调用的完整参数列表请见[生数科技创建参考生成视频任务](https://support.huaweicloud.com/model-call-maas/model-call-076.html)以及[爱诗科技创建参考生成视频任务](https://support.huaweicloud.com/model-call-maas/model-call-082.html)。 #### 创建参考生视频（生数科技） 此处以使用ViduQ3-Turbo R2V模型通过Python脚本和Curl命令生成视频为例，展示基于参考图像和文本提示词生成视频的基本用法。 1. 创建视频生成任务。 - [Python] ``` import requests import json if __name__ == '__main__': url = "https://api.modelarts-maas.com/v1/video/generations" # API地址 api_key = "MAAS_API_KEY" # 把 MAAS_API_KEY 替换成已获取的API Key # Send request. headers = { 'Content-Type': 'application/json', 'Authorization': f'Bearer {api_key}' } data = { "model": "vidu/viduq3-turbo_reference2video", "input": { "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。", "media": [ { "type": "image_url", "url": "https://example/image1.jpg" }, { "type": "image_url", "url": "https://example/image2.jpg" }, { "type": "image_url", "url": "https://example/image3.jpg" } ] }, "parameters": { "size": "1280*720", "duration": 5, "audio": True } } response = requests.post(url, headers=headers, data=json.dumps(data), verify=False) # Print result. print(response.status_code) print(response.text) ``` 响应示例 ``` { "task_id" : "962939796957712384" } ``` - [Curl] ``` curl -X POST "https://api.modelarts-maas.com/v1/video/generations" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $MAAS_API_KEY" \ -d '{ "model": "vidu/viduq3-turbo_reference2video", "input": { "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。", "media": [ { "type": "image_url", "url": "https://example/image1.jpg" }, { "type": "image_url", "url": "https://example/image2.jpg" }, { "type": "image_url", "url": "https://example/image3.jpg" } ] }, "parameters": { "size": "1280*720", "duration": 5, "audio": true } }' ``` 响应示例 ``` { "task_id" : "962939796957712384" } ``` 2. 根据视频生成任务id获取视频。 ![](https://support.huaweicloud.com/model-call-maas/public_sys-resources/note_3.0-zh-cn.png) 视频生成为异步接口，您需要先创建视频生成任务，再通过视频生成任务的ID去查询视频生成结果。视频生成过程耗时较长，查询结果时请您耐心等待。 - [Python] ``` import requests import json if __name__ == '__main__': url = "https://api.modelarts-maas.com/v1/video/generations/task_id" # API地址。请将task_id替换为实际的ID，您可以通过创建视频生成任务API获取。 api_key = "MAAS_API_KEY" # 把yourApiKey替换成已获取的API Key # Send request. headers = { 'Content-Type': 'application/json', 'Authorization': f'Bearer {api_key}' } response = requests.get(url, headers=headers, verify=False) # Print result. print(response.status_code) print(response.text) ``` **响应示例** ``` { "task_id" : "962939796957712384", "status" : "succeeded", "error" : null, "content" : { "result_url" : "https://example.com/example.mp4" }, "usage" : { "duration" : 5, "size" : "1280*720", "audio" : true, "shot_type" : "single" }, "created_at" : 1780281309530, "updated_at" : 1780281338634 } ``` - [Curl] ``` curl -X GET 'https://api.modelarts-maas.com/v1/video/generations/task_id' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $MAAS_API_KEY" ``` **响应示例** ``` { "task_id" : "962939796957712384", "status" : "succeeded", "error" : null, "content" : { "result_url" : "https://example.com/example.mp4" }, "usage" : { "duration" : 5, "size" : "1280*720", "audio" : true, "shot_type" : "single" }, "created_at" : 1780281309530, "updated_at" : 1780281338634 } ``` #### 创建参考生视频（爱诗科技） 此处以使用PixVerse V6 R2V模型通过Python脚本和Curl命令生成视频为例，展示基于参考图像和文本提示词生成视频的基本用法。 1. 创建视频生成任务。 - [Python] ``` import requests import json if __name__ == '__main__': url = "https://api.modelarts-maas.com/v1/video/generations" # API地址 api_key = "MAAS_API_KEY" # 把 MAAS_API_KEY 替换成已获取的API Key # Send request. headers = { 'Content-Type': 'application/json', 'Authorization': f'Bearer {api_key}' } data = { "model": "pixverse/pixverse-v6-r2v", "input": { "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群@sheep 缓慢走动，远处有连绵青山。", "media": [ { "type": "image_url", "url": "https://example/image1.jpg" }, { "type": "image_url", "url": "https://example/image2.jpg" }, { "type": "image_url", "url": "https://example/image3.jpg", "ref_name": "sheep" } ] }, "parameters": { "resolution": "720p", "ratio": "16:9", "duration": 5, "audio": False } } response = requests.post(url, headers=headers, data=json.dumps(data), verify=False) # Print result. print(response.status_code) print(response.text) ``` 响应示例 ``` { "task_id": "408913047245542", "resolution": "720p", "duration": 5, "audio": false } ``` - [Curl] ``` curl -X POST "https://api.modelarts-maas.com/v1/video/generations" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $MAAS_API_KEY" \ -d '{ "model": "pixverse/pixverse-v6-r2v", "input": { "prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群@sheep 缓慢走动，远处有连绵青山。", "media": [ { "type": "image_url", "url": "https://example/image1.jpg" }, { "type": "image_url", "url": "https://example/image2.jpg" }, { "type": "image_url", "url": "https://example/image3.jpg", "ref_name": "sheep" } ] }, "parameters": { "resolution": "720p", "ratio": "16:9", "duration": 5, "audio": false } }' ``` 响应示例 ``` { "task_id": "408913047245542", "resolution": "720p", "duration": 5, "audio": false } ``` 2. 根据视频生成任务id获取视频。 ![](https://support.huaweicloud.com/model-call-maas/public_sys-resources/note_3.0-zh-cn.png) 视频生成为异步接口，您需要先创建视频生成任务，再通过视频生成任务的ID去查询视频生成结果。视频生成过程耗时较长，查询结果时请您耐心等待。 - [Python] ``` import requests import json if __name__ == '__main__': url = "https://api.modelarts-maas.com/v1/video/generations/task_id" # API地址。请将task_id替换为实际的ID，您可以通过创建视频生成任务API获取。 api_key = "MAAS_API_KEY" # 把yourApiKey替换成已获取的API Key # Send request. headers = { 'Content-Type': 'application/json', 'Authorization': f'Bearer {api_key}' } response = requests.get(url, headers=headers, verify=False) # Print result. print(response.status_code) print(response.text) ``` **响应示例** ``` { "task_id": "408913047245542", "status": "succeeded", "error": { "code": 0, "message": "" }, "content": { "result_url": "https://example.com/example.mp4" }, "usage": { "duration": 5, "audio": false, "resolution": "720p" }, "created_at": 1781786928000, "updated_at": 1781787020000 } ``` - [Curl] ``` curl -X GET 'https://api.modelarts-maas.com/v1/video/generations/task_id' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $MAAS_API_KEY" ``` **响应示例** ``` { "task_id": "408913047245542", "status": "succeeded", "error": { "code": 0, "message": "" }, "content": { "result_url": "https://example.com/example.mp4" }, "usage": { "duration": 5, "audio": false, "resolution": "720p" }, "created_at": 1781786928000, "updated_at": 1781787020000 } ```