# 预测结果查询
#### 功能介绍
根据item列表查询预测的时序数据结果。
#### URI
POST /v1/predictions
获取URI方式请参见[请求URI](https://support.huaweicloud.com/api-pangulm/pangulm_05_0004.html)。
#### 请求参数
表1请求Header参数（Token认证） 
| 参数           | 是否必选        | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| X-Auth-Token | 是（云上部署模型填写） | String | **参数解释：** 用户Token。 用于获取操作API的权限。[图4](https://support.huaweicloud.com/api-pangulm/pangulm_05_0009.html#pangulm_05_0009__fig10797003103)响应消息头中X-Subject-Token的值即为Token。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| Content-Type | 是           | String | **参数解释：** 发送的实体的MIME类型。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** application/json                                                                                                                                                                  |
   
表2请求Header参数（API Key认证） 
| 参数             | 是否必选                            | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| X-Apig-AppCode | 是（云上部署模型填写、边缘部署模型仅在监控网关访问模式下填写） | String | **参数解释：** API Key值。 用于获取操作API的权限。[API Key认证](https://support.huaweicloud.com/api-pangulm/pangulm_05_0009.html#pangulm_05_0009__section148602501261)响应消息头中X-Apig-AppCode的值即为API Key。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| Content-Type   | 是                               | String | **参数解释：** 发送的实体的MIME类型。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** application/json                                                                                                                                                                                |
   
表3请求Body参数 
| 参数            | 参数类型           | 描述                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| items         | List\[String\] | **参数解释：** 需要查询的item列表。 **约束限制：** 不涉及 **取值范围：** 列表元素在可查询的item列表中（参考/v2/items的返回体）。 **默认取值：** 不涉及                        |
| infer_task_id | String         | **参数解释：** 推理任务ID。 **约束限制：** 不涉及 **取值范围：** 通过POST /v1/inference接口提交的推理任务ID，或训练工作流日志中打印的推理任务ID。 **默认取值：** 此项为空时，默认返回最后一次推理的结果。 |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数         | 参数类型         | 描述                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| start_time | String       | **参数解释：** 时序起始时间。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                |
| data       | Dict\[List\] | **参数解释：** 各item的时序预测结果。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及          |
| quantiles  | Dict\[Dict\] | **参数解释：** 各item的时序分位数预测结果。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
**状态码： 400**
表5响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|
| error_code | String | **参数解释：** 错误码。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及    |
| error_msg  | String | **参数解释：** 错误信息。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
#### 请求示例
```
{"items": ["生活家电", "生活家电/空调"]}
```
#### 响应示例
```
{
  "start_time": "2026-4-25",
  "data": {
    "生活家电": [35, 64, 98],
    "生活家电/空调": [22, 35, 12]
  }
  "quantiles": {
    "生活家电/空调": {"10": [5, 7, 2], "90": [33, 46, 19]}
  }
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0019.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0020.html)。