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

功能描述

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

前提条件

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

输入限制

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

调试

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

请求参数

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

要执行的操作。取值：RecognizeFurnitureSpu。
ImageURL String 是 https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/jiaju.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。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。
PredCate String 单人沙发

预测类目的中文名称。
PredCateId String c2dcb449-4729-4cfe-9e38-1fc1453211a5

预测类目的名称ID。
PredProbability Float 0.9521462917327881

预测类目的置信率。
RequestId String 39942935-D32B-4925-973D-445E421031B6

请求ID。

示例

请求示例

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

正常返回示例

XML 格式 

<RequestId>39942935-D32B-4925-973D-445E421031B6</RequestId>
<Data>
    <PredProbability>0.9521462917327881</PredProbability>
    <PredCate>单人沙发</PredCate>
    <PredCateId>c2dcb449-4729-4cfe-9e38-1fc1453211a5</PredCateId>
</Data>

JSON 格式 

{
	"RequestId": "39942935-D32B-4925-973D-445E421031B6",
	"Data": {
		"PredProbability": "0.9521462917327881",
		"PredCate": "单人沙发",
		"PredCateId": "c2dcb449-4729-4cfe-9e38-1fc1453211a5"
	}
}

错误码

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

SDK参考

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

安全声明

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