数据万象图像主体检测-API 文档-文档中心-腾讯云

功能描述
腾讯云数据万象通过 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>
﻿

参数名称	描述	类型	是否必选
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	否

节点名称（关键字）	父节点	描述	类型
RecognitionResult	无	保存 Logo 识别结果的容器。	Container

图像主体检测

本页目录：

功能描述

授权说明

服务开通

使用限制

费用说明

请求

请求语法

请求内容

请求头

请求体

响应

响应头

响应体

示例

请求

响应