创建视频生成任务
创建视频生成任务API用于根据给定的输入信息，如文本提示词、图片（仅I2V模式）等，结合指定的模型及视频处理参数，生成相应的视频。其业务逻辑是将用户输入的各种参数传递给后端模型进行处理，最终输出生成的视频链接。
接口信息
|
名称 |
说明 |
取值 |
|---|---|---|
|
API地址 |
调用创建视频生成任务的API地址。 |
https://api.modelarts-maas.com/v1/video/generations |
|
model参数 |
model参数调用名称。 |
您可以通过任选以下方式获取model参数值。
|
支持模型列表
请求参数说明
|
参数名称 |
参数类型 |
是否必填 |
说明 |
|---|---|---|---|
|
model |
string |
是 |
模型名称，具体请参见表2的“model参数值”列。 |
|
input |
object |
是 |
输入的基本信息，如提示词、图片。关于子参数的说明，请参见表4。 |
|
parameters |
object |
否 |
视频内容生成参数。关于子参数的说明，请参见表5。 |
|
参数名称 |
参数类型 |
是否必填 |
默认值 |
说明 |
|---|---|---|---|---|
|
prompt |
string |
|
无 |
文本提示词，支持中英文，不超过1000字符。 |
|
img_url |
string |
是 |
无 |
说明：
仅支持图生视频模型。 输入给模型的图片内容，填写图片的Base64编码内容。图片大小不超过8MB。 目前仅支持JPEG（JPG）格式的图片，请按照如下格式输入：
|
|
参数名称 |
参数类型 |
是否必填 |
默认值 |
说明 |
|---|---|---|---|---|
|
size |
string |
否 |
1280*720 |
直接设置为目标分辨率的具体数值，格式为宽*高，例如720*1280。支持如下档位分辨率：
说明：
I2V模型分为480P和720P两个版本，调用时只支持模型版本对应的分辨率。 |
|
fps |
integer |
否 |
16 |
生成视频每秒的帧数，当前只支持8和16。 |
|
duration |
integer |
否 |
5 |
生成视频时长，单位为秒，当前只支持3s和5s。 |
|
seed |
integer |
否 |
0 |
随机种子，用于控制生成内容的随机性。取值范围为[0，2147483648]。 |
响应参数说明
|
参数名称 |
参数类型 |
说明 |
|---|---|---|
|
task_id |
string |
任务ID。 |
文生视频请求示例
- 使用Python调用示例：
import requests import json if __name__ == '__main__': url = "https://api.modelarts-maas.com/v1/embeddings" # 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 } }'
图生视频请求示例
- 使用Python调用示例。
import requests import json if __name__ == '__main__': url = "https://api.modelarts-maas.com/v1/embeddings" # 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...." # 图片大小不超过8MB }, "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 } }'
响应示例
{
"task_id": "e0cc914f-66bb-402a-912b-990fa1e4ab42",
}
