文档首页/ 魔坊（ModelArts）模型训推平台/ 抽屉式帮助/ 创建模型/ apis定义
更新时间：2026-04-20 GMT+08:00
分享

apis定义

解释说明

提供模型对外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": "application/json",
        "data": {
            "type": "object",
            "properties": {
                "mnist_result": {
                    "type": "array",
                    "item": [
                        {
                            "type": "string"
                        }
                    ]
                }
            }
        }
    }
}]
父主题： 创建模型

相关文档