相似度比较_图像搜索(Image Search)-阿里云帮助中心

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	CompareSimilarByImage	系统规定参数。取值：CompareSimilarByImage。
PrimaryPicContent	String	是	AAAANSUhEUgAAAPcAAAEVCAYAAAA8d3NuAAAAAXNSR0IArs......RK5CYII=	图片内容。图片大小要求不超过4 MB。图片格式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。传输等待时间不超过5秒。服务类型为商品图片搜索、通用图片搜索、家具家居图片搜索和工业五金图片搜索时，图片长和宽像素要求大于等于100PX且小于等于4096PX。服务类型为商标图片搜索时，图片长和宽像素要求大于等于200PX且小于4096PX。服务类型为布料图片搜索时，图片长和宽像素要求大于等于448PX且小于等于4096PX。图片中不能包含旋转信息。说明使用SDK方式调用：仅支持V3版本SDK，无需填写PrimaryPicContent字段，SDK已将本字段封装为PrimaryPicContentObject字段并自动转化为Base64编码。具体示例参考 JAVA SDK。 SDK不支持客户直接传递图片URL，V3版本SDK提供了一种变相实现URL上传的方式。具体示例参考 JAVA SDK。
SecondaryPicContent	String	是	AAAANSUhEUgAAAPcAAAEVCAYAAAA8d3NuAAAAAXNSR0IArs......RK5CYII=	图片内容。图片大小要求不超过4 MB。图片格式：PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。传输等待时间不超过5秒。服务类型为商品图片搜索、通用图片搜索、家具家居图片搜索和工业五金图片搜索时，图片长和宽像素要求大于等于100PX且小于等于4096PX。服务类型为商标图片搜索时，图片长和宽像素要求大于等于200PX且小于4096PX。服务类型为布料图片搜索时，图片长和宽像素要求大于等于448PX且小于等于4096PX。图片中不能包含旋转信息。说明使用SDK方式调用：仅支持V3版本SDK，无需填写PrimaryPicContent字段，SDK已将本字段封装为PrimaryPicContentObject字段并自动转化为Base64编码。具体示例参考 JAVA SDK。 SDK不支持客户直接传递图片URL，V3版本SDK提供了一种变相实现URL上传的方式。具体示例参考 JAVA SDK。
InstanceName	String	是	demoinstance1	图搜实例名称。最多支持20个字符。如果已经购买图搜实例可登录图像搜索管控台查看。如果没有购买图搜实例可参考开通服务和创建实例。说明这里的实例名称并非实例ID，使用时请区分。

返回数据

名称	类型	示例值	描述
Score	double	0.85	图片相似打分。取值范围：0~1。
Success	Boolean	true	请求是否成功。
RequestId	String	B3137727-7D6E-488C-BA21-0E034C38A879	请求ID。
Msg	String	success	错误信息。
AccessDeniedDetail	Object		鉴权返回集合。
AuthAction	String	xxx	鉴权请求Action。
AuthPrincipalDisplayName	String	111	鉴权主体信息。
AuthPrincipalOwnerId	String	222	鉴权主体的主账号ID。
AuthPrincipalType	String	SubUser	鉴权主体类型。
EncodedDiagnosticMessage	String	xxxxxx	加密后的完整诊断信息。
NoPermissionType	String	ImplicitDeny	ImplicitDeny：未命中任何策略。 ExplicitDeny：明确命中Deny策略。
PolicyType	String	AccountLevelIdentityBasedPolicy	引起无权限的策略类型。
Code	Integer	0	错误码。 0：成功。非0：失败。

示例

请求示例

http(s)://[Endpoint]/?Action=CompareSimilarByImage
&PrimaryPicContent=AAAANSUhEUgAAAPcAAAEVCAYAAAA8d3NuAAAAAXNSR0IArs......RK5CYII=
&SecondaryPicContent=AAAANSUhEUgAAAPcAAAEVCAYAAAA8d3NuAAAAAXNSR0IArs......RK5CYII=
&InstanceName=demoinstance1
&公共请求参数

正常返回示例

XML格式

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

<CompareSimilarByImageResponse>
    <Score>0.85</Score>
    <Success>true</Success>
    <RequestId>B3137727-7D6E-488C-BA21-0E034C38A879</RequestId>
    <Msg>success</Msg>
    <AccessDeniedDetail>
        <AuthAction>xxx</AuthAction>
        <AuthPrincipalDisplayName>111</AuthPrincipalDisplayName>
        <AuthPrincipalOwnerId>222</AuthPrincipalOwnerId>
        <AuthPrincipalType>SubUser</AuthPrincipalType>
        <EncodedDiagnosticMessage>xxxxxx</EncodedDiagnosticMessage>
        <NoPermissionType>ImplicitDeny</NoPermissionType>
        <PolicyType>AccountLevelIdentityBasedPolicy</PolicyType>
    </AccessDeniedDetail>
    <Code>0</Code>
</CompareSimilarByImageResponse>

JSON格式

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

{
  "Score" : 0.85,
  "Success" : true,
  "RequestId" : "B3137727-7D6E-488C-BA21-0E034C38A879",
  "Msg" : "success",
  "AccessDeniedDetail" : {
    "AuthAction" : "xxx",
    "AuthPrincipalDisplayName" : "111",
    "AuthPrincipalOwnerId" : "222",
    "AuthPrincipalType" : "SubUser",
    "EncodedDiagnosticMessage" : "xxxxxx",
    "NoPermissionType" : "ImplicitDeny",
    "PolicyType" : "AccountLevelIdentityBasedPolicy"
  },
  "Code" : 0
}