图像主体检测

最近更新时间:2024-04-09 15:54:34

我的收藏

功能描述

腾讯云数据万象通过 AIObjectDetect 接口实现对图片内不同主体的识别,返回图片中识别到主体 的名称、坐标、置信度分值。
注意:
本接口属于 GET 请求,为同步请求方式,需携带签名,具体签名设置请参见 请求签名

授权说明

通过子账号使用时,需要授予 ci:CreateAIObjectDetectJob权限,详情请参见 数据万象 action

服务开通

使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶
使用该功能需提前通过控制台或接口开通 AI 内容识别服务 。详情请参见 开通 AI 内容识别服务

使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制

费用说明

该接口为付费服务,产生的费用将由数据万象收取,详细计费说明可参见 内容识别费用

请求

请求语法

原图存储在 COS:
GET /<ObjectKey>?ci-process=AIObjectDetect HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
原图来自其他链接:
GET /?ci-process=AIObjectDetect&detect-url=<detect-url> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明:
Authorization: 携带鉴权信息,用于验证请求的合法性的请求头,Pic-Operations头部需签入签名信息中,详情请参见 请求签名 文档。

请求内容

参数名称
描述
类型
是否必选
ObjectKey
对象文件名,例如:folder/document.jpg。
String
ci-process
数据万象处理能力,图片主体检测接口固定为:AIObjectDetect。
String
detect-url
您可以通过填写 detect-url 处理任意公网可访问的图片链接。不填写 detect-url 时,后台会默认处理 ObjectKey ,填写了 detect-url 时,后台会处理 detect-url 链接,无需再填写 ObjectKey。
detect-url 示例:http://www.example.com/abc.jpg ,需要进行 UrlEncode,处理后为http%25253A%25252F%25252Fwww.example.com%25252Fabc.jpg
String

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该请求无请求体。

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据,具体的数据内容如下:
节点名称(关键字)
父节点
描述
类型
RecognitionResult
保存 Logo 识别结果的容器。
Container
Response 的内容:
节点名称(关键字)
父节点
描述
类型
Status
RecognitionResult
主体识别结果状态。0表示未识别到,1表示识别到。
Int
DetectMultiObj
RecognitionResult
主体识别结果,可能有多个。
Container
LogoInfo 节点内容:
节点名称(关键字)
父节点
描述
类型
Name
DetectMultiObj
识别到主体的名称。
String
Sorce
DetectMultiObj
识别到主体的置信度,取值范围为[0-100]。值越高概率越大。
Int
Location
DetectMultiObj
图中识别到主体的坐标。
Container
Location 节点内容:
节点名称(关键字)
父节点
描述
类型
X
Location
识别主体框左上角横坐标。
Int
Y
Location
识别主体框左上角纵坐标。
Int
Width
Location
识别主体框高度。
Int
Height
Location
识别主体框高度。
Int

示例

请求

GET /?ci-process=AIObjectDetect&detect-url=xxx HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: xxxxx
Authorization:XXXXXXXXXXXX

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 414641
Date: xxxxxx
Server: tencent-ci
x-cos-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhfMjc=

<RecognitionResult>
<Status>1</Status>
<DetectMultiObj>
<Confidence>93</Confidence>
<Location>
<Height>475</Height>
<Width>407</Width>
<X>512</X>
<Y>533</Y>
</Location>
<Name></Name>
</DetectMultiObj>
<DetectMultiObj>
<Confidence>81</Confidence>
<Location>
<Height>658</Height>
<Width>960</Width>
<X>82</X>
<Y>58</Y>
</Location>
<Name>汽车</Name>
</DetectMultiObj>
</RecognitionResult>