地堆面积推理

4.1.1 顶层参数

说明：

• RagId 不能为空。

• 同一请求中的全部 SkuId，都应能在该 RagId 对应知识库中查询到完整资产。

• 更换知识库时，请同步修改 RagId，不要沿用错误的库 ID。

4.1.2 Products 内部结构

关键约束：

• 同一请求中不得重复提交相同的 SkuId。

• 同一 SKU 的多个实例应合并在同一个 Products[] 元素的 Boxes 中。

• SkuId 必须已经在对应 RagId 知识库中完成建设。

• 调用方不需要传 SkuName、尺寸或参考图。

4.1.3 Boxes 内部结构

边界框坐标格式为：

[Left, Top, Right, Bottom]

坐标范围与方向约束：

0 <= Left < Right <= 1000
0 <= Top < Bottom <= 1000

上游检测框为像素坐标时，可按目标图宽高转换为归一化坐标：

Left   = pixelLeft   / imageWidth  × 1000
Top    = pixelTop    / imageHeight × 1000
Right  = pixelRight  / imageWidth  × 1000
Bottom = pixelBottom / imageHeight × 1000

图片要求

• 图片地址必须使用 HTTPS，且能够被服务端正常访问。

• 支持 JPEG、PNG、WebP 等常见图片格式。

• 图片应完整覆盖需要计算面积的地堆区域。

• 避免严重模糊、过曝、欠曝和大面积遮挡。

• 使用签名 URL 时，建议有效期不少于 30 分钟。

• 同一巡检任务存在多张目标图时，每张目标图分别调用一次接口。

SKU 知识库前置要求

调用前，请确认：

1. 已准备好目标 SKU 所在知识库的 RagId。

2. 请求中的每个 SkuId，均已在该知识库中维护以下信息：

若 RagId 不正确，或 SkuId 未在对应知识库中建库，请求会在模型推理前被拦截并返回业务错误。

4.3.1 顶层字段

4.3.2 Result 内部结构

Result 仅包含面积计算结果：

4.3.3 Stage 4：面积结果

计算规则：

area_m2      = left_edge_m × right_edge_m

面积及边长按算法约定四舍五入到 4 位小数。

1）多个 SKU 的地堆面积结果

{
  "ReqId": "didui-area-20260728-001",
  "Result": {
    "stage4_area_label": {
      "left_edge_m": 1.35,
      "right_edge_m": 0.6,
      "area_m2": 0.81
    }
  }
}

2）SkuId 未完成知识库建设 / 入参校验失败

该情况在调用模型前被拦截，对外响应中 Result 为 null：

{
  "ReqId": "didui-area-20260728-002",
  "Result": null
}

3）同一 SKU 出现多个独立实例

请求时将多个实例放入同一个 Products[].Boxes：

{
  "ReqId": "didui-area-20260728-003",
  "TargetImageUrl": "https://example.com/images/store-001/didui-002.jpg",
  "RagId": "rag_xxxxxxxxxxxxxxxx",
  "Products": [
    {
      "SkuId": "yl_whh_whh_adg220P_24X_1",
      "Boxes": [
        {
          "Left": 100,
          "Top": 300,
          "Right": 280,
          "Bottom": 640
        },
        {
          "Left": 282,
          "Top": 301,
          "Right": 462,
          "Bottom": 642
        },
        {
          "Left": 464,
          "Top": 302,
          "Right": 644,
          "Bottom": 643
        }
      ]
    }
  ]
}

模型会综合目标图、商品实例框和知识库信息计算，并仅返回 Stage 4 面积结果。