店头场景识别-电商经营助手-阿里云帮助中心

1、产品简介

基于店头场景识别与多模态大模型元素定位构建的门店照片审核产品。产品输出店头场景分类及可用置信度明细，同时定位店面、店招、入口和营业标识，适用于门店资料采集、店头照片分类与巡检复核。

2、适用场景

店头照片分类：区分店头相关照片与非店面照片。
门店资料核查：定位店招与入口，提取清晰可读的短文本。
多门店照片复核：分别定位相邻门店的可见店面和标识。

3、功能介绍

场景分类与明细：返回 scenes 字符串数组和 details 分类明细；非店面照也是有效分类结果。
店头关键元素定位：覆盖店面、店招、门店入口、营业相关标识。
可读文字摘录：仅摘录清晰短文本；不根据门的开闭推断营业状态，不推断地址或门店归属。

支持单张 HTTPS 图片输入；补充定位最多返回 12 个目标，每个目标包含类别、位置框和最多 24 字的可见文字，并通过 coverage 标明定位是否完整。

4、开发指南

本文请求和响应字段遵循对应搭建文档的实际大小写及结构。示例为业务工作流输入输出，不额外假设平台网关封装；对外调用地址、鉴权方式和网关封装应以实际发布接口为准。

4.1 请求参数

参数名	类型	必填	说明
imageUrl	String	是	待识别原图的 HTTPS 地址；须可访问，不含空白或 URL 用户名密码

4.2 请求示例

{
  "imageUrl": "https://example.com/images/api-04.jpg"
}

示例图片地址和知识库标识（如有）为占位值，调用时替换为实际资源。

4.3 响应参数

通用字段：

字段路径	类型	说明
success	Boolean	调用是否成功；有效业务结论不等于审核通过
errorCode	String	成功为空字符串；失败为错误码
errorMessage	String	成功为空字符串；失败为具体错误说明
result	Object	业务结果；失败时为空对象
usageMap	Object	成功为 {"ProcessingCount":1}；失败为空对象
usageMap.ProcessingCount	Integer	成功处理计数为 1；失败时该字段不返回

业务字段：

字段路径	类型	说明
result.scenes	Array	非空场景分类数组；完整分类枚举未在源文档中列出
result.details	Array	分类明细，可为空数组

| result.details[ ].class | String | 非空类别名称 |

| result.details[ ].confidence | Number | 有限数值；源文档未规定数值范围 |

补充定位字段：

字段路径	类型	说明
result.grounding	Object	补充元素定位结果
result.grounding.coverage	String	complete：相关可见目标完整；partial：仅部分目标有效或可辨认
result.grounding.regions	Array	目标数组，最多 12 项；没有相关目标时可为空

| result.grounding.regions[ ].label | String | 目标类别，枚举见下表 |

| result.grounding.regions[ ].bbox_2d | Integer[4] | [左上x,左上y,右下x,右下y]；0–1000；左<右，上<下 |

| result.grounding.regions[ ].text | String | 最多 24 字的可确认短名称或文字；看不清时为空字符串 |

目标类别：

label	含义
storefront	店面整体
store_sign	店招
entrance	门店入口
business_sign	营业相关标识

坐标换算：横坐标像素值 = 横坐标 × 原图宽度 / 1000；纵坐标像素值 = 纵坐标 × 原图高度 / 1000。

定位仅有部分结果时可返回 success=true、coverage=partial。发生截断时，仅保留已完整解析的合法目标；删除无效框、去重、截短文字或超出目标数量限制也会标记 partial。合法空 regions 可成功，但不代表前置业务结果也允许为空。若定位服务失败、结果无法恢复或所有框均无效，则整条请求失败。

4.4 响应示例

以下均为结构示例，非实测结果。

1）成功响应

{
  "success": true,
  "errorCode": "",
  "errorMessage": "",
  "result": {
    "scenes": [
      "非店面照"
    ],

    "details": [ ],

    "grounding": {
      "coverage": "complete",

      "regions": [ ]

    }
  },
  "usageMap": {
    "ProcessingCount": 1
  }
}

2）补充定位仅返回部分结果

{
  "success": true,
  "errorCode": "",
  "errorMessage": "",
  "result": {
    "scenes": [
      "非店面照"
    ],

    "details": [ ],

    "grounding": {
      "coverage": "partial",

      "regions": [ ]

    }
  },
  "usageMap": {
    "ProcessingCount": 1
  }
}

参数错误响应

{
  "success": false,
  "errorCode": "InvalidParameter",
  "errorMessage": "imageUrl 必须为有效的 HTTPS 图片地址",
  "usageMap": {},
  "result": {}
}

处理失败响应

{
  "success": false,
  "errorCode": "DownstreamUnavailable",
  "errorMessage": "未获得有效的元素定位结果",
  "usageMap": {},
  "result": {}
}

4.5 错误码

错误码	含义	处理建议
InvalidParameter	输入不合法或识别服务明确返回业务错误	根据 errorMessage 修正参数或业务输入后重新调用
DownstreamUnavailable	鉴权、限流、超时、空响应、缺字段或解析等处理异常	根据 errorMessage 检查资源与服务状态；临时故障可稍后重试

应结合 success、errorCode、errorMessage 判断结果。源搭建文档未约定每类业务错误对应的 HTTP 状态码。平台公共错误码可参考错误码，本接口工作流错误码以上表为准。