文档首页/ AI开发平台ModelArts/ ModelArts Studio（MaaS）用户指南/ ModelArts Studio（MaaS）在线推理服务/ ModelArts Studio（MaaS） API调用规范/ 视频生成/ 创建视频生成任务

更新时间：2025-09-16 GMT+08:00

查看PDF

创建视频生成任务

创建视频生成任务API用于根据给定的输入信息，如文本提示词、图片（仅I2V模式）等，结合指定的模型及视频处理参数，生成相应的视频。其业务逻辑是将用户输入的各种参数传递给后端模型进行处理，最终输出生成的视频链接。

接口信息

表1 接口信息
名称	说明	取值
API地址	调用创建视频生成任务的API地址。	https://api.modelarts-maas.com/v1/video/generations
model参数	model参数调用名称。	您可以通过任选以下方式获取model参数值。从表2的“model参数值”列获取。在“预置服务 > 商用服务”页签的服务名称左侧，单击图标，在“model参数”列查看取值。更多信息，请参见在ModelArts Studio（MaaS）预置服务中开通商用服务。在“预置服务 > 自定义接入点”页签的“model参数”列查看取值。更多信息，请参见在ModelArts Studio（MaaS）预置服务中创建自定义接入点。

支持模型列表

表2 支持模型列表
模型系列	模型版本	支持地域	model参数值	应用场景
通义万相	Wan2.1-T2V-1.3B	西南-贵阳一	wan2.1-t2v-1.3b	文字生成视频
	Wan2.1-T2V-14B	西南-贵阳一	wan2.1-t2v-14b	文字生成视频
	Wan2.1-I2V-14B-480P	西南-贵阳一	wanx2.1-i2v-14b-480p	图片生成视频（首帧）
	Wan2.1-I2V-14B-720P	西南-贵阳一	wanx2.1-i2v-14b-720p	图片生成视频（首帧）
	Wan2.2-I2V-A14B	西南-贵阳一	Wan2.2-I2V-A14B	图片生成视频
	Wan2.2-T2V-A14B	西南-贵阳一	Wan2.2-T2V-A14B	文字生成视频

请求参数说明

表3 请求body参数（body体需要小于8M）
参数名称	参数类型	是否必填	说明
model	string	是	模型名称，具体请参见表2的“model参数值”列。
input	object	是	输入的基本信息，如提示词、图片。关于子参数的说明，请参见表4。
parameters	object	否	视频内容生成参数。关于子参数的说明，请参见表5。

表4 input子参数说明
参数名称	参数类型	是否必填	默认值	说明
prompt	string	文生视频模型必填图生视频模型选填	无	文本提示词，支持中英文，不超过1000字符。
img_url	string	是	无	说明：仅支持图生视频模型。输入给模型的图片内容，填写图片的Base64编码内容。目前仅支持JPEG（JPG）格式的图片，请按照如下格式输入：示例一： "data:image/jpeg;base64,iVBORw0KG...." 示例二： "data:image/jpg;base64,iVBORw0KG...."

表5 parameters子参数说明
参数名称	参数类型	是否必填	默认值	说明
size	string	否	1280*720	直接设置为目标分辨率的具体数值。 Wan2.1格式为宽高，例如7201280。支持如下档位分辨率： 480P档位：不同视频宽高比对应的分辨率如下： 16:9：832480 9:16：480832 720P档位：不同视频宽高比对应的分辨率如下： 16:9：1280720 9:16：7201280 Wan2.2格式为宽x高，例如720x1280。支持如下档位分辨率： 480P档位：不同视频宽高比对应的分辨率如下： 16:9：832x480 9:16：480x832 720P档位：不同视频宽高比对应的分辨率如下： 16:9：1280x720 9:16：720x1280 说明： Wan2.1-I2V-14B模型分为480P和720P两个版本，调用时只支持模型版本对应的分辨率。
fps	integer	否	16	生成视频每秒的帧数，当前只支持8和16。
duration	integer	否	5	生成视频时长，单位为秒，当前只支持3s和5s。
seed	integer	否	0	随机种子，用于控制生成内容的随机性。取值范围为[0，2147483648]。

响应参数说明

参数名称	参数类型	说明
task_id	string	任务ID。

Wan2.1-T2V-14B文生视频请求示例

Rest API的示例代码如下。

使用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": "wan2.1-t2v-14b",  # model参数 
        "input": { 
            "prompt": "小猫在散步", 
        }, 
        "parameters": { 
            "size": "720*1280",    # 根据调用模型，填写相应的分辨率
            "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)

使用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": "wan2.1-t2v-14b", 
    "input": { 
        "prompt": "小猫在散步"
    }, 
    "parameters": { 
        "size": "720*1280", 
        "fps": 16, 
        "duration": 5, 
        "seed": 0 
    } 
}'

Wan2.1-I2V-14B-720P图生视频请求示例

使用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": "wan2.1-i2v-14b-720p",  # model参数 
        "input": { 
            "prompt": "小猫在散步", 
            "img_url": "data:image/jpg;base64,iVBORw0KG...."  # jpg图片base64编码。
        }, 
        "parameters": { 
            "size": "720*1280", 
            "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)

使用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": "wan2.1-i2v-14b-720p", 
    "input": { 
        "prompt": "小猫在散步",
        "img_url": "data:image/jpg;base64,iVBORw0KG...."
    }, 
    "parameters": { 
        "size": "720*1280", 
        "fps": 16, 
        "duration": 5, 
        "seed": 0 
    } 
}'

Wan2.2-T2V-A14B文生视频请求示例

Rest API的示例代码如下。

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": "Wan2.2-T2V-A14B",  # model参数
        "input": {
            "prompt": "小猫在散步",
        },
        "parameters": {
            "size": "720x1280",   # 根据调用模型，填写相应的分辨率，支持"1280x720"、 "720x1280"、 "480x832"或"832x480"。
            "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)

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": "Wan2.2-T2V-A14B",
    "input": {
        "prompt": "小猫在散步"
    },
    "parameters": {
        "size": "720x1280",
        "fps": 16,
        "duration": 5,
        "seed": 0
    }
}'

Wan2.2-I2V-A14B图生视频请求示例

Rest API的示例代码如下。

Python示例

import base64
import requests
import json


#  Base64 编码格式
def encode_image(image_path):
    with open(image_path, "rb") as image_file:
        return base64.b64encode(image_file.read()).decode("utf-8")


base64_image = encode_image(r"D:\Pictures\image.jpg") # jpg图片base64编码。

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-I2V-A14B",  # model参数
        "input": {
            "prompt": "小猫在散步",
            "img_url": f"data:image/jpg;base64,{base64_image}"  
        },
        "parameters": {
            "size": "720x1280",  # 根据调用模型，填写相应的分辨率，支持"1280x720"、 "720x1280"、 "480x832"或"832x480"。
            "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)

cURL示例

请将示例中的“$BASE64_IMAGE”替换为实际的base64。

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-I2V-A14B",
    "input": {
        "prompt": "小猫在散步",
        "img_url": "data:image/jpg;base64,$BASE64_IMAGE"
    },
    "parameters": {
        "size": "720x1280",
        "fps": 16,
        "duration": 5,
        "seed": 0
    }
}'

响应示例

{
  "task_id": "e0cc914f-66bb-402a-912b-990fa1e4ab42",
}

父主题： 视频生成

上一篇：视频生成

下一篇：查询视频生成任务

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问

创建视频生成任务

接口信息

支持模型列表

请求参数说明

响应参数说明

Wan2.1-T2V-14B文生视频请求示例

Wan2.1-I2V-14B-720P图生视频请求示例

Wan2.2-T2V-A14B文生视频请求示例

Wan2.2-I2V-A14B图生视频请求示例

响应示例

相关文档

意见反馈

文档内容是否对您有帮助？