更新时间：2026-06-16 GMT+08:00
基于首尾帧生视频
图生视频中的基于首尾帧技术，简单来说就是利用两张静态图片作为起点和终点，通过模型自动补全中间的过程，生成一段流畅的视频。
MaaS支持模型以及相关参数，请参见支持模型。
支持模型
| 模型系列 | 模型名称 | 版本 | model参数 | 支持输入类型 | 支持输出类型 | 最大输入长度 | 支持帧率（fps） | 输出视频最高分辨率 | 输出最大视频时长 | 默认限流 | 支持地域 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 生数科技 | ViduQ3-Pro KF2V | 20260211 | vidu/viduq3-pro_start-end2video | 文本、图片 | 视频 | 文本：5000 字符 图片：50 MB（Base64编码） | 24 | 1080p | 16s | RPM: 300 | 西南-贵阳一 |
| ViduQ3-Turbo KF2V | 20260211 | vidu/viduq3-turbo_start-end2video | 文本、图片 | 视频 | 文本：5000 字符 图片：50 MB（Base64编码） | 24 | 1080p | 16s | RPM: 300 |
前提条件
- 已在页签开通预置服务。详情请见开通MaaS预置服务。
- （可选）如果需要控制服务调用流量，可提前创建自定义接入点，详情请参见MaaS创建自定义接入点。
- 已获取API Key。详情请见在MaaS管理API Key。
- 已获取模型服务的model参数值。详情请见支持模型。
使用限制
- 任务数据（如任务状态、视频URL等）仅保留24小时，超时后会被自动清除。请您务必及时保存生成的视频。
- 不同模型的限制值不同，具体限制值请以MaaS控制台“在线推理>预置服务”页面的模型限流列为准 。
- TPM：每分钟处理的Tokens数（输入+输出）。
- RPM：每分钟处理的请求数。
API说明
模型调用的完整参数列表请见生数科技创建首尾帧生成视频任务。
创建首尾帧生视频（生数科技）
此处以使用ViduQ3-Pro KF2V模型通过Python脚本和Curl命令生成视频为例，展示基于首尾帧图像和文本提示词生成视频的基本用法。
1. 创建视频生成任务。
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-pro_start-end2video",
"input": {
"prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。",
"media": [
{
"type": "first_frame",
"url": "https://example/first_frame.jpg"
},
{
"type": "last_frame",
"url": "https://example/last_frame.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 -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-pro_start-end2video",
"input": {
"prompt": "蓝天白云下的郊外草原，微风拂动青草，羊群缓慢走动，远处有连绵青山。",
"media": [
{
"type": "first_frame",
"url": "https://example/first_frame.jpg"
},
{
"type": "last_frame",
"url": "https://example/last_frame.jpg"
}
]
},
"parameters": {
"size": "1280*720",
"duration": 5,
"audio": true
}
}' 响应示例
{
"task_id" : "962939796957712384"
} 2. 根据视频生成任务id获取视频。
视频生成为异步接口，您需要先创建视频生成任务，再通过视频生成任务的ID去查询视频生成结果。视频生成过程耗时较长，查询结果时请您耐心等待。
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" : "720*1280",
"audio" : true,
"shot_type" : "single"
},
"created_at" : 1780281309530,
"updated_at" : 1780281338634
} 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" : "720*1280",
"audio" : true,
"shot_type" : "single"
},
"created_at" : 1780281309530,
"updated_at" : 1780281338634
} 
