更新时间:2026-07-13 GMT+08:00
分享

盘古供热行业模型

功能介绍

针对供热行业工况场景,升级统一编码模型架构。增加了供热机组数据融合训练、独立训练,融合部署架构和算法等功能。注意,推理请使用单机组数据作为请求体。

URI

POST /inference

获取URI方式请参见请求URI

请求参数

表1 请求Header参数(Token认证)

参数

是否必选

参数类型

描述

X-Auth-Token

是(云上部署模型填写)

String

参数解释:

用户Token。

用于获取操作API的权限。图4响应消息头中X-Subject-Token的值即为Token。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

Content-Type

String

参数解释:

发送的实体的MIME类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json。

表2 请求Header参数(API Key认证)

参数

是否必选

参数类型

描述

X-Apig-AppCode

是(云上部署模型填写、边缘部署模型仅在监控网关访问模式下填写)

String

参数解释:

API Key值。

用于获取操作API的权限。API Key认证响应消息头中X-Apig-AppCode的值即为API Key。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

Content-Type

String

参数解释:

发送的实体的MIME类型。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

application/json。

表3 请求Body参数

参数

是否必选

参数类型

描述

unit_id

String

参数解释:

机组id。

约束限制:

参考实际供热中,机组id即可。

取值范围:

限制为字符串类型。

默认取值:

不涉及

input_data

json

参数解释:

推理请求体包括的天气、温度等数据。

约束限制:

参考input_data下的子字段

取值范围:

不涉及

默认取值:

不涉及

表4 input_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

参数解释:

当启动服务时,本次请求服务各阶段耗时情况。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表6 InferenceRes格式说明

参数名称

参数类型

说明

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
    }
}

状态码

请参见状态码

错误码

请参见错误码

相关文档