华为云首页用户手册

AI开发平台MODELARTS-通过Token认证的方式访问在线服务:方式一：使用图形界面的软件进行预测（以Postman为例）

时间：2024-10-15 14:28:16

AI开发平台MODELARTS

方式一：使用图形界面的软件进行预测（以Postman为例）

下载Postman软件并安装，您也可以直接在Chrome浏览器添加Postman扩展程序（也可使用其他支持发送post请求的软件）。Postman推荐使用7.24.0版本。
打开Postman，如图3所示。
图3 Postman界面
在Postman界面填写参数，以图像分类举例说明。
- 选择POST任务，将在线服务的调用地址复制到POST后面的方框。Headers页签的Key值填写为“X-Auth-Token”，Value值为用户Token。
  
  您也可以通过AK（Access Key ID）/SK（Secret Access Key)加密调用请求，具体可参见用户AK-SK认证模式。
  
  图4 参数填写
- 在Body页签，根据AI应用的输入参数不同，可分为2种类型：文件输入、文本输入。
  - 文件输入
    选择“form-data”。在“KEY”值填写AI应用的入参，和在线服务的输入参数对应，比如本例中预测图片的参数为“images”。然后在“VALUE”值，选择文件，上传一张待预测图片（当前仅支持单张图片预测），如图5所示。
    
    图5 填写Body
  - 文本输入
    选择“raw”，选择JSON(application/json)类型，在下方文本框中填写请求体，请求体样例如下：
```
{
  "meta": {
    "uuid": "10eb0091-887f-4839-9929-cbc884f1e20e"
  },
  "data": {
    "req_data": [
      {
        "sepal_length": 3,
        "sepal_width": 1,
        "petal_length": 2.2,
        "petal_width": 4
      }
    ]
  }
}
```
    其中，“meta”中可携带“uuid”，调用时传入一个“uuid”，返回预测结果时回传此“uuid”用于跟踪请求，如无此需要可不填写meta。“data”包含了一个“req_data”的数组，可传入单条或多条请求数据，其中每个数据的参数由AI应用决定，比如本例中的“sepal_length”、“sepal_width”等。
参数填写完成，单击“send”发送请求，结果会在“Response”下的对话框里显示。
- 文件输入形式的预测结果样例如图6所示，返回结果的字段值根据不同AI应用可能有所不同。
- 文本输入形式的预测结果样例如图7所示，请求体包含“meta”及“data”。如输入请求中包含“uuid”，则输出结果中回传此“uuid”。如未输入，则为空。“data”包含了一个“resp_data”的数组，返回单条或多条输入数据的预测结果，其中每个结果的参数由AI应用决定，比如本例中的“sepal_length”、“predictresult”等。
  图6 文件输入预测结果
  
   图7 文本输入预测结果