# 热量温度模型预测 #### 功能介绍 针对供热行业工况场景，升级统一编码模型架构。增加了供热机组数据融合训练、独立训练，融合部署架构和算法等功能。注意，推理请使用单机组数据作为请求体。 #### URI POST /inference 获取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参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | unit_id | 是 | String | **参数解释：** 机组id。 **约束限制：** 参考实际供热中，机组id即可。 **取值范围：** 限制为字符串类型。 **默认取值：** 不涉及 | | input_data | 是 | json | **参数解释：** 推理请求体包括的天气、温度等数据。 **约束限制：** 参考[input_data下的子字段]。 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表4input_data下的子字段 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | tt301_value | 是 | Float | **参数解释：** 室外温度。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** \[-50,50\] **默认取值：** 不涉及 | | ww301_value | 是 | Float | **参数解释：** 风速。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** \[0,100\] **默认取值：** 不涉及 | | wp301_value | 是 | Int | **参数解释：** 天气现象。 **约束限制：** 使用所在地区的天气数据，参考取值范围。 **取值范围：** - -1： 无 - 0: 晴 - 1: 多云 - 2: 阴 - 3: 阵雨 - 4: 雷阵雨 - 5: 雷阵雨伴有冰雹 - 6: 雨夹雪 - 7: 小雨 - 8: 中雨 - 9: 大雨 - 10: 暴雨 - 11: 大暴雨 - 12: 特大暴雨 - 13: 阵雪 - 14: 小雪 - 15: 中雪 - 16: 大雪 - 17: 暴雪 - 18: 雾 - 19: 冻雨 - 20: 沙尘暴 - 21: 小到中雨 - 22: 中到大雨 - 23: 大到暴雨 - 24: 暴雨到大暴雨 - 25: 大暴雨到特大暴雨 - 26: 小到中雪 - 27: 中到大雪 - 28: 大到暴雪 - 29: 浮尘 - 30: 扬沙 - 31: 强沙尘暴 - 53: 霾 - 32: 浓雾 - 49: 强浓雾 - 54: 中度霾 - 55: 重度霾 - 56: 严重霾 - 57: 大雾 - 58: 特强浓雾 - 301: 雨 - 302: 雪 **默认取值：** 不涉及 | | wp301_past | 是 | Int | **参数解释：** 过去3天连续天气现象，默认不存在。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** - -1： 无 - 0: 晴 - 1: 多云 - 2: 阴 - 3: 阵雨 - 4: 雷阵雨 - 5: 雷阵雨伴有冰雹 - 6: 雨夹雪 - 7: 小雨 - 8: 中雨 - 9: 大雨 - 10: 暴雨 - 11: 大暴雨 - 12: 特大暴雨 - 13: 阵雪 - 14: 小雪 - 15: 中雪 - 16: 大雪 - 17: 暴雪 - 18: 雾 - 19: 冻雨 - 20: 沙尘暴 - 21: 小到中雨 - 22: 中到大雨 - 23: 大到暴雨 - 24: 暴雨到大暴雨 - 25: 大暴雨到特大暴雨 - 26: 小到中雪 - 27: 中到大雪 - 28: 大到暴雪 - 29: 浮尘 - 30: 扬沙 - 31: 强沙尘暴 - 53: 霾 - 32: 浓雾 - 49: 强浓雾 - 54: 中度霾 - 55: 重度霾 - 56: 严重霾 - 57: 大雾 - 58: 特强浓雾 - 301: 雨 - 302: 雪 **默认取值：** 不涉及 | | wd301_value | 是 | Int | **参数解释：** 风向。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** - 0 无持续风向 - 1 东北风 - 2 东风 - 3 东南风 - 4 南风 - 5 西南风 - 6 西风 - 7 西北风 - 8 北风 - 9 旋转风 **默认取值：** 不涉及 | | heating_period | 是 | Int | **参数解释：** 供暖期 **约束限制：** 使用所在地区的天气数据 **取值范围：** - 1：初寒期 - 2：严寒期 - 3：末寒期 **默认取值：** 不涉及 | | holiday | 是 | int | **参数解释：** 节假日 **约束限制：** 使用所在地区的日期数据 **取值范围：** - 0：工作日 - 1：普通周末或其他节假日 - 2：元旦或春节 **默认取值：** 不涉及 | | building_type | 是 | Float | **参数解释：** 建筑类型 **约束限制：** 使用所在地区的建筑类型。 **取值范围：** 不涉及 **默认取值：** 不涉及 | | building_insulation_grade | 是 | Int | **参数解释：** 建筑保温等级。 **约束限制：** 使用所在地区的建筑。 **取值范围：** - 1：一步节能 - 2：二步节能 - 3：三步节能 - 4：四步节能 - 0：未知 - 9：非节能建筑 **默认取值：** 不涉及 | | heating_type | 是 | Int | **参数解释：** 供热类型。 **约束限制：** 使用所在地区的供热类型。 **取值范围：** - 1：地热 - 2：挂暖 - 3：混合 - 4：空调 - 5：未知 **默认取值：** 不涉及 | | timestamp | 是 | Float | **参数解释：** 时间戳。 **约束限制：** 根据机组实际需要推理时间填写。 **取值范围：** 由伙伴数据库数据决定。 **默认取值：** 不涉及 | | t3_past_12 | 是 | Float | **参数解释：** 历史12小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | | t3_past_24 | 是 | Float | **参数解释：** 历史24小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | | t3_past_36 | 是 | Float | **参数解释：** 历史36小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | | t3_past_48 | 是 | Float | **参数解释：** 历史48小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | | t3_future_12 | 是 | Float | **参数解释：** 未来12小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | | t3_future_24 | 是 | Float | **参数解释：** 未来24小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | | t3_future_36 | 是 | Float | **参数解释：** 未来36小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | | t3_future_48 | 是 | Float | **参数解释：** 未来48小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | | t3_future_72 | 是 | Float | **参数解释：** 未来72小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | | t3_future_96 | 是 | Float | **参数解释：** 未来96小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | | t3_future_120 | 是 | Float | **参数解释：** 未来120小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | | t3_future_144 | 是 | Float | **参数解释：** 未来144小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | | t3_future_168 | 是 | Float | **参数解释：** 未来168小时平均天气。 **约束限制：** 使用所在地区的天气数据。 **取值范围：** 无 **默认取值：** 不涉及 | #### 响应参数 **状态码： 200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | inference_res | List\<[表6 InferenceRes格式说明]\> | **参数解释：** 预测结果。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | time_cost | JSON | **参数解释：** 当启动服务时，本次请求服务各阶段耗时情况。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表6InferenceRes格式说明 | 参数名称 | **参数类型** | **说明** | |:---|:---|:---| | tt301_value | Float | **参数解释：** 室外温度。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | jt121_value | Float | **参数解释：** 机组一次侧瞬热。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | tt211_value | Float | **参数解释：** 机组二供温。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | tt221_value | Float | **参数解释：** 机组二回温。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | tt201_mean | Float | **参数解释：** 机组二均温。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | **状态码： 400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 错误码。 | | error_msg | String | 错误信息。 | #### 请求示例 ``` { "unit_id": "tj01_04_0206_01", "input_data": [ { "tt301_value": -3.6, "ww301_value": 4.7, "wp301_value": 0, "wp301_past": -1, "wd301_value": 0, "heating_period": 2, "holiday": 1, "building_type": 0, "building_insulation_grade": 9, "heating_type": 5, "timestamp": "1759248000", "t3_past_12": -3.6, "t3_past_24": -3.6, "t3_past_36": -3.6, "t3_past_48": -3.6, "t3_future_12": -3.6, "t3_future_24": -3.6, "t3_future_36": -3.6, "t3_future_48": -3.6, "t3_future_72": -3.6, "t3_future_96": -3.6, "t3_future_120": -3.6, "t3_future_144": -3.6, "t3_future_168": -3.6 } ] } ``` #### 响应示例 ``` { "inference_res": [ { "jt121_value": 0.8128629326820374, "tt201_mean": 41.37767791748047, "tt211_value": 43.74068832397461, "tt221_value": 39.01466751098633, "tt301_value": -3.6 } ], "time_cost": { "infer_cost_time": 105.53932189941406, "postprocess_cost_time": 0.07915496826171875, "preprocess_cost_time": 0.2205371856689453, "service_cost_total_time": 109.831 } } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0019.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0020.html)。