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

调用说明

只有当预置服务-免费服务有免费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参数调用名称。

请任选以下方式获取:

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

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

复制以下调用示例并替换接口信息、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
    
    if __name__ == '__main__':
        url = "https://api.modelarts-maas.com/v1/video/generations/task_id"  # API地址,task_id可以通过创建视频生成任务API获取。
        api_key = "MAAS_API_KEY"  # 把MAAS_API_KEY替换成已获取的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示例:

    请将task_id替换为实际的ID,您可以通过创建视频生成任务API获取。

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

相关文档