文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>数据万象

图像主体检测

最近更新时间：2025-08-29 14:48:52

我的收藏

本页目录：

功能描述

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

授权说明

通过子账号使用时，需要在 授权策略 的 action 中添加 ci:CreateAIObjectDetectJob权限。数据万象支持的所有操作接口请参见 CI action。

服务开通

使用该功能需提前 绑定存储桶，开通数据万象服务。
注意：
数据万象绑定后，如果您手动对存储桶进行数据万象的解绑操作，将无法继续使用该功能。

使用限制

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

费用说明

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

请求

请求语法

原图存储在 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: 携带鉴权信息，用于验证请求的合法性的请求头，详情请参见 请求签名 文档。

请求内容

参数名称
描述
类型
是否必选
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%3A%2F%2Fwww.example.com%2Fabc.jpg。
String
否

请求头

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

请求体

该请求无请求体。

响应

响应头

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

响应体

该响应体返回为 application/xml 数据，具体的数据内容如下：
节点名称（关键字）
父节点
描述
类型
RecognitionResult
无
保存主体识别结果的容器。
Container
Response 的内容：
节点名称（关键字）
父节点
描述
类型
Status
RecognitionResult
主体识别结果状态。0表示未识别到，1表示识别到。
Int
DetectMultiObj
RecognitionResult
主体识别结果，可能有多个。
Container
DetectMultiObj 节点内容：
节点名称（关键字）
父节点
描述
类型
Name
DetectMultiObj
识别到主体的名称。
String
Confidence
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=http%3A%2F%2Fwww.example.com%2Fabc.jpg HTTP/1.1
Host: examplebucket-1250000000.cos.ap-chengdu.myqcloud.com
Date: Thu, 15 Jun 2025 12:37:29 GMT
Authorization:q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************

响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 414641
Date: Thu, 15 Jun 2025 12:37:29 GMT
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>

中国站
目录