视频生成
在当今的数字内容创作领域,创作者们经常面临从零开始制作视频的挑战,这不仅耗时而且需要专业的编辑技能。视频生成模型具备出色的语义理解能力,可根据用户输入的文本、图片等内容,快速生成优质的视频片段,极大地简化了视频创作过程。然而,对于许多初学者来说,如何有效地利用这些高级工具仍然是一个难题。
通过这篇教程您可以学习到如何通过调用视频生成模型API来生成视频,涵盖文生视频、图生视频(通用/舞蹈/唱演/播报等)等应用场景,从而轻松地将创意转化为高质量的视频内容。
计费说明
按Token计费:统计模型进行实时推理服务时消耗的Token数量,按Token数量付费。
Wan2.2系列模型的视频Token用量 ≈ (宽 × 高 × 帧率 × 生成视频时长)/256,最终数据请以实际产生为准。具体价格请以MaaS控制台为准。
详情请见MaaS视频生成模型计费项。
使用限制
- 任务数据(如任务状态、视频URL等)仅保留24小时,超时后会被自动清除。请您务必及时保存生成的视频。
- 不同模型的限制值不同,具体限制值请以MaaS控制台“在线推理>预置服务”页面的模型限流列为准 。
- TPM:每分钟处理的Tokens数(输入+输出)。
- RPM:每分钟处理的请求数。
前提条件
- 已在页签开通预置服务。详情请见开通MaaS预置服务。
- (可选)如果需要控制服务调用流量,可提前创建自定义接入点,详情请参见MaaS创建自定义接入点。
- 已获取API Key。详情请见在MaaS管理API Key。
- 已获取模型服务的model参数值。详情请见创建视频生成任务。
快速开始
您可以通过下面代码快速体验文生视频能力。
视频生成为异步接口,您需要先创建视频生成任务,再通过视频生成任务的ID去查询视频生成结果。视频生成过程耗时较长,查询结果时请您耐心等待。
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": "Wan2.2-T2V-A14B", # model参数
"input": {
"prompt": "小猫在散步",
},
"parameters": {
"size": "720x1280", # 参照填写相应的分辨率。
"fps": 16,
"duration": 5,
"seed": 0
}
}
response = requests.post(url, headers=headers, data=json.dumps(data), verify=False)
# Print result.
print(response.status_code)
print(response.text)
{
"task_id": "e0cc914f-66bb-402a-912b-990fa1e4ab42",
}
curl -X POST "https://api.modelarts-maas.com/v1/video/generations" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $MAAS_API_KEY" \
-d '{
"model": "Wan2.2-T2V-A14B",
"input": {
"prompt": "小猫在散步"
},
"parameters": {
"size": "720x1280",
"fps": 16,
"duration": 5,
"seed": 0
}
}'
{
"task_id": "e0cc914f-66bb-402a-912b-990fa1e4ab42",
}
查询视频生成任务
通过创建视频生成任务生成的视频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": "330b74a382a6d42044f146f389cd698e",
"status": "succeeded",
"error": {
"code": 0,
"message": ""
},
"content": {
"result_url": "https://modelarts.obs.com/example.mp4"
},
"usage": {
"model_latency": 43564,
"completion_tokens": 124800,
"prompt_tokens": 0,
"total_tokens": 124800
},
"created_at": 1751894112234,
"updated_at": 1751894156753
}
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": "330b74a382a6d42044f146f389cd698e",
"status": "succeeded",
"error": {
"code": 0,
"message": ""
},
"content": {
"result_url": "https://modelarts.obs.com/example.mp4"
},
"usage": {
"model_latency": 43564,
"completion_tokens": 124800,
"prompt_tokens": 0,
"total_tokens": 124800
},
"created_at": 1751894112234,
"updated_at": 1751894156753
}
API说明
模型调用的完整参数列表请见视频生成。
支持模型
当前支持视频生成的模型请参见视频生成。
图生视频
Wan2.2-I2V-A14B模型将输入图片作为视频首帧,再根据提示词生成视频。视频呈现丰富的艺术风格及影视级画质。
- 输入输出示例:
表1 输入输出示例 输入图片
提示词
输出视频

小猫在散步。
- 图生视频请求和响应示例:图生视频请求示例-Wan2.2-I2V-A14B。
文生视频
Wan2.2-T2V-A14B模型通过一句话即可生成视频,视频呈现丰富的艺术风格及影视级画质。
- 输入输出示例:
表2 输入输出示例 输入示例
输出视频
小猫在散步
- 文生视频请求和响应示例:文生视频请求示例-Wan2.2-T2V-A14B。