调用说明

只有当“预置服务 > 免费服务”有免费token额度或在免费有效期内、“预置服务-商用服务”的付费状态为“已开通”、或者自定义接入点的状态为“使用中”时，预置服务才可被成功调用。

服务调用产生的内容由AI生成，不代表ModelArts Studio观点，平台不保证其合法性、真实性、准确性，不承担相关法律责任。

步骤一：获取API Key

在调用MaaS的模型服务时，需要填写API Key用于接口的鉴权认证。请创建新的API Key或使用已有API Key。关于如何创建API Key，请参见在ModelArts Studio（MaaS）管理API Key。

步骤二：创建视频生成任务

复制以下调用示例并替换接口信息、API Key。关于参数的详细说明，请参考创建视频生成任务。

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

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 
    } 
}'

图生视频：

使用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 
    } 
}'

步骤三：查询视频生成任务

复制以下调用示例并替换接口信息、API Key。关于参数的详细说明，请参考，请参考查询视频生成任务。

表2 接口信息
名称	说明	取值
API地址	查询视频生成任务的API地址，需要在链接末尾拼接生成任务的task_id。 task_id可以通过创建视频生成任务API获取。	https://api.modelarts-maas.com/v1/video/generations/{task_id}

Rest API的示例代码如下。

Python示例：

import requests 
import json

if __name__ == '__main__': 
    url = "https://api.modelarts-maas.com/v1/video/generations/{task_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)

cURL示例：

curl -X GET 'https://api.modelarts-maas.com/v1/video/generations/{task_id}' \ 
  -H "Content-Type: application/json" \ 
  -H "Authorization: Bearer $MAAS_API_KEY"

父主题： ModelArts Studio（MaaS）

上一篇：权重路径

下一篇：调用说明