本文介绍家居SPU识别RecognizeFurnitureSpu的语法及示例。

功能描述

家居SPU识别能力可以对输入的家居模型图进行分类。目前类别数可达70种，包括：餐椅、折叠椅、餐车、鞋柜、婴儿床、组合沙发、间厅柜/玄关柜、壁炉柜、梳妆台、吧台、八仙桌、酒柜、卡座、沙发贵妃椅、休闲桌椅组合、罗汉床/榻、组合床、三人沙发、儿童床、儿童桌椅、电脑椅、壁柜、床头柜、餐桌椅组合、其他、装饰架、炕几/床几、玄关台、多人沙发、经典中式椅、角几/边几、床架、饰物柜、单人沙发、双人沙发、电视柜、餐桌、凳/墩、按摩椅、儿童柜类、梳妆椅/梳妆凳、休闲椅、书椅、单人床、斗柜、床凳、床垫、边柜、茶几、躺椅、L型沙发、衣帽架、隔断/屏风、博古架、书桌/书台、高低床、多功能床、懒人沙发、U型沙发、转角部件、衣柜、书桌椅组合、双人床、榻位部件、吊椅、电视柜组合、花几/香几、摇椅、吧椅、角柜/架。

前提条件

请确保您已开通商品理解服务，若未开通服务请立即开通。

输入限制

  • 图像格式：JPEG、JPG、PNG。
  • 图像大小：不超过10 MB。
  • 图像分辨率：不限制图片分辨率，但图片分辨率太高可能会导致API识别超时，超时时间为5秒。
  • URL地址中不能包含中文字符。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 RecognizeFurnitureSpu

系统规定参数。取值：RecognizeFurnitureSpu。

ImageURL String 是 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/goodstech/RecognizeFurnitureSpu/RecognizeFurnitureSpu1.jpg

图像的URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。

XLength Float 是 70.7

输入图像中待识别物品X轴方向的尺寸，单位cm，默认值100。
YLength Float 是 80.8

输入图像中待识别物品Y轴方向的尺寸，单位cm，默认值100。
ZLength Float 是 66.66

输入图像中待识别物品Z轴方向的尺寸，单位cm，默认值100。

返回数据

名称 类型 示例值 描述
RequestId String C2558FE7-A929-5F6B-AF38-6E4F9927FCDC

请求ID。
Data Object

返回的结果数据内容。
PredCateId String f2c08afc-68c8-42a7-b62c-1b648f87edba

预测类目的名称ID。
PredCate String 休闲椅

预测类目的中文名称。
PredProbability Float 0.4627198278903961

预测类目的置信率。

示例

请求示例

http(s)://goodstech.cn-shanghai.aliyuncs.com/?Action=RecognizeFurnitureSpu
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/goodstech/RecognizeFurnitureSpu/RecognizeFurnitureSpu1.jpg
&XLength=70.7
&YLength=80.8
&ZLength=66.66
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<RecognizeFurnitureSpuResponse>
    <RequestId>C2558FE7-A929-5F6B-AF38-6E4F9927FCDC</RequestId>
    <Data>
        <PredCateId>f2c08afc-68c8-42a7-b62c-1b648f87edba</PredCateId>
        <PredCate>休闲椅</PredCate>
        <PredProbability>0.46271983</PredProbability>
    </Data>
</RecognizeFurnitureSpuResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "C2558FE7-A929-5F6B-AF38-6E4F9927FCDC",
  "Data" : {
    "PredCateId" : "f2c08afc-68c8-42a7-b62c-1b648f87edba",
    "PredCate" : "休闲椅",
    "PredProbability" : 0.46271983
  }
}

错误码

关于家居SPU识别的错误码，详情请参见常见错误码。

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。