数据万象
有奖捉虫：行业应用 & 管理与支持文档专题 HOT
文档中心 > 数据万象 > API 文档 > AI 内容识别 > 图像主体检测

图像主体检测

最近更新时间：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>

中国站