j9九游会登录/ 大模型即服务平台 maas/ 用户指南/ maas api调用规范/ / 创建视频生成任务
更新时间：2026-02-09 gmt 08:00

创建视频生成任务-j9九游会登录

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

约束限制

  • 对于支持图片上传的模型，单个图片文件的大小不超过10mb。如果以base64编码形式上传图片，需确保编码后的图片小于10mb。
  • 该功能仅支持“西南-贵阳一”区域。

接口信息

表1 接口信息

名称

说明

取值

api地址

调用创建视频生成任务的api地址。

https://api.modelarts-maas.com/v1/video/generations

model参数

model参数调用名称。

您可以任选以下方式获取model参数值。

  • 从表2的“model参数值”列获取。
  • 预置服务：在“模型推理 > 在线推理 > 预置服务”页签的服务名称左侧，单击图标，在“model参数”列查看取值。具体操作，请参见maas开通预置服务。
  • 自定义接入点：在“模型推理 > 在线推理 > 自定义接入点”页签的“model参数”列查看取值。更多信息，请参见创建自定义接入点。

支持模型列表

表2 支持模型列表

模型系列

模型版本

支持地域

model参数值

应用场景

通义万相

wan2.2-i2v-a14b

西南-贵阳一

wan2.2-i2v-a14b

图片生成视频

wan2.2-t2v-a14b

西南-贵阳一

wan2.2-t2v-a14b

文字生成视频

请求参数说明

表3 请求body参数（body体需要小于8mb）

参数名称

参数类型

是否必填

说明

model

string

是

模型名称，具体请参见表2的“model参数值”列。

input

object

是

输入的基本信息，如提示词、图片。关于子参数的说明，请参见表4。

parameters

object

否

视频处理参数。关于子参数的说明，请参见表5。
表4 input子参数说明

参数名称

参数类型

是否必填

默认值

说明

prompt

string
  • 文生视频模型必填
  • 图生视频模型选填

无

文本提示词，支持中英文，最大长度为1000字符。

img_url

string

是

无
说明：

仅支持图生视频模型。

输入给模型的图片内容，填写图片的base64编码内容或公网可访问的url地址。

支持的图片的格式：jpg、png、webp、jpeg、bmp。示例如下：

  • 填写图片的base64编码内容： 
    "img_url": "data:image/jpg;base64,ivborw0kg...."
  • 填写公网可访问的图片地址： 
    "img_url": "https://example/xxx.png"
表5 parameters子参数说明

参数名称

参数类型

是否必填

默认值

说明

size

string

否

1280*720

生成视频的分辨率档位，当前支持如下档位：

  • 480p档位：不同视频宽高比对应的分辨率如下。
    • 16:9：832x480
    • 9:16：480x832
  • 720p档位：不同视频宽高比对应的分辨率如下。
    • 16:9：1280x720
    • 9:16：720x1280
  • 1080p档位：不同视频宽高比对应的分辨率如下。
    • 16:9：1920x1080
    • 9:16：1080x1920

size参数应直接设置为目标分辨率的具体数值（如720x1280）。

注意：720p和1080p输出视频的宽度和高度均为64的整数倍，且接近于输入的分辨率。

说明：

fps

integer

否

16

生成视频每秒的帧数，当前只支持16、24、30。

duration

integer

否

5

生成视频时长，单位为秒，当前只支持3s和5s。

seed

integer

否

无

随机种子，用于控制生成内容的随机性。取值范围为[0，2147483648]。

响应参数说明

参数名称

参数类型

说明

task_id

string

任务id。

文生视频请求示例-wan2.2-t2v-a14b

此处以使用wan2.2-t2v-a14b模型通过python脚本和curl命令生成视频为例，展示文本生成视频的基本用法。

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",   # 参照表5填写相应的分辨率。
            "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 -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

此处以使用wan2.2-i2v-a14b模型通过python脚本和curl命令生成视频为例，展示图片生成视频的基本用法。

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") # 图片base64编码，支持jpg、png、webp、jpeg、bmp。
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}"  # 支持填写图片的base64编码后的内容或公网可访问的url地址，支持jpg、png、webp、jpeg、bmp。
        },
        "parameters": {
            "size": "720x1280",  # 参照表5，填写相应的分辨率。
            "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)

请将示例中的“$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",
}
父主题：

相关文档

网站地图