盘古供热行业模型
功能介绍
针对供热行业工况场景,升级统一编码模型架构。增加了供热机组数据融合训练、独立训练,融合部署架构和算法等功能。注意,推理请使用单机组数据作为请求体。
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是(云上部署模型填写) | String | 参数解释: 用户Token。 用于获取操作API的权限。图4响应消息头中X-Subject-Token的值即为Token。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| Content-Type | 是 | String | 参数解释: 发送的实体的MIME类型。 约束限制: 不涉及 取值范围: 不涉及 默认取值: application/json。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Apig-AppCode | 是(云上部署模型填写、边缘部署模型仅在监控网关访问模式下填写) | String | 参数解释: API Key值。 用于获取操作API的权限。API Key认证响应消息头中X-Apig-AppCode的值即为API Key。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| Content-Type | 是 | String | 参数解释: 发送的实体的MIME类型。 约束限制: 不涉及 取值范围: 不涉及 默认取值: application/json。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| unit_id | 是 | String | 参数解释: 机组id。 约束限制: 参考实际供热中,机组id即可。 取值范围: 限制为字符串类型。 默认取值: 不涉及 |
| input_data | 是 | json | 参数解释: 推理请求体包括的天气、温度等数据。 约束限制: 取值范围: 不涉及 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| tt301_value | 是 | Float | 参数解释: 室外温度。 约束限制: 使用所在地区的天气数据。 取值范围: [-50,50] 默认取值: 不涉及 |
| ww301_value | 是 | Float | 参数解释: 风速。 约束限制: 使用所在地区的天气数据。 取值范围: [0,100] 默认取值: 不涉及 |
| wp301_value | 是 | Int | 参数解释: 天气现象。 约束限制: 使用所在地区的天气数据,参考取值范围。 取值范围:
默认取值: 不涉及 |
| wp301_past | 是 | Int | 参数解释: 过去3天连续天气现象,默认不存在。 约束限制: 使用所在地区的天气数据。 取值范围:
默认取值: 不涉及 |
| wd301_value | 是 | Int | 参数解释: 风向。 约束限制: 使用所在地区的天气数据。 取值范围:
默认取值: 不涉及 |
| heating_period | 是 | Int | 参数解释: 供暖期 约束限制: 使用所在地区的天气数据 取值范围:
默认取值: 不涉及 |
| holiday | 是 | int | 参数解释: 节假日 约束限制: 使用所在地区的日期数据 取值范围:
默认取值: 不涉及 |
| building_type | 是 | Float | 参数解释: 建筑类型 约束限制: 使用所在地区的建筑类型。 取值范围: 不涉及 默认取值: 不涉及 |
| building_insulation_grade | 是 | Int | 参数解释: 建筑保温等级。 约束限制: 使用所在地区的建筑。 取值范围:
默认取值: 不涉及 |
| heating_type | 是 | Int | 参数解释: 供热类型。 约束限制: 使用所在地区的供热类型。 取值范围:
默认取值: 不涉及 |
| 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
| 参数 | 参数类型 | 描述 |
|---|---|---|
| inference_res | List<表6 InferenceRes格式说明> | 参数解释: 预测结果。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| time_cost | JSON | 参数解释: 当启动服务时,本次请求服务各阶段耗时情况。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| tt301_value | Float | 参数解释: 室外温度。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| jt121_value | Float | 参数解释: 机组一次侧瞬热。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| tt211_value | Float | 参数解释: 机组二供温。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| tt221_value | Float | 参数解释: 机组二回温。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| tt201_mean | Float | 参数解释: 机组二均温。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
状态码: 400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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
}
} 状态码
请参见状态码。
错误码
请参见错误码。