AI开发平台MODELARTS-apis定义:解释说明

时间:2024-12-20 10:08:04

解释说明

提供模型对外Restfull api数据定义,用于定义模型的输入、输出格式。apis为结构体数据,填写规范请参见模型配置文件编写说明中的apis参数说明。
表1 api数据结构说明

参数

是否必选

参数类型

描述

url

String

请求路径。默认值为“/”。 自定义镜像 的模型需要根据镜像内实际暴露的请求路径填写“url”。非自定义镜像模型,“url”只能为“/”。

method

String

请求方法。默认值为“POST”。

request

Object

请求体。包含两个参数:

  • Content-type:指定发送内容类型,默认值为“application/json”。
    一般情况包括如下两种内容类型:
    • “application/json”,发送json数据。
    • “multipart/form-data”,上传文件。

    机器学习,仅支持“application/json”。

  • data:发送数据结构,以json schema描述。json schema说明请参考官方指导

response

Object

响应体。包含两个参数:

  • Content-type:指定接收内容类型,默认值为“application/json”。
  • data:接收数据结构,以json schema描述。json schema说明请参考官方指导

apis参数代码示例如下:

[{
    "url": "/",
    "method": "post",
    "request": {
        "Content-type": "multipart/form-data",
        "data": {
            "type": "object",
            "properties": {
                "images": {
                    "type": "file"
                }
            }
        }
    },
    "response": {
        "Content-type": "applicaton/json",
        "data": {
            "type": "object",
            "properties": {
                "mnist_result": {
                    "type": "array",
                    "item": [
                        {
                            "type": "string"
                        }
                    ]
                }
            }
        }
    }
}]
support.huaweicloud.com/drawer-modelarts/ma_drawer_030.html