调用说明

只有当预置服务-免费服务有免费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）预置服务中开通商用服务。在“预置服务 > 自定义接入点”页签的“model参数”列查看取值。更多信息，请参见在ModelArts Studio（MaaS）预置服务中创建自定义接入点。

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") # 仅支持JPEG（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
    }
}'

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

复制以下调用示例并替换接口信息、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替换为实际的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"

父主题： ModelArts Studio（MaaS）

上一篇：调用说明

下一篇：调用说明