主体识别-智能开放搜索 OpenSearch(Open Search)-阿里云帮助中心

支持从图像中自动检测并识别一个或多个主要目标，适用于智能监控、自动驾驶、图像检索等典型计算机视觉应用场景。

服务名称	服务ID	服务描述	API调用QPS限制（含主账号与RAM子账号）
主体识别服务	ops-object-detect-001	由阿里云 OpenSearch-AI 团队自研多主体检测模型，可检测图片中多个独立主体，输出主体位置框及置信分。可用于复杂场景中主体提取，作为下游任务的输入，可排除图片背景或其他主体对下游embedding和rerank模型的干扰。	20 说明如需扩充QPS，请通过工单联系技术支持协助。

人脸识别服务	ops-object-detect-face-001	从图像中自动定位并识别人脸，支持多个人脸的识别，适用于智能监控、图像检索等应用。

前提条件

获取身份鉴权信息
通过API调用AI搜索开放平台服务时，需要对调用者身份进行鉴权，如何获取鉴权信息请参见获取API-KEY。
获取服务调用地址
支持通过公网和VPC两种方式调用服务，详情请参见获取服务接入地址。

请求说明

公共说明

请求body最大不能超过8MB。

请求方式

POST

URL

{host}/v3/openapi/workspaces/{workspace_name}/image-object-detection/{service_id}

参数说明：

host：调用服务的地址，支持通过公网和VPC两种方式调用API服务，可参见获取服务接入地址。其中，公网API域名用于公网环境访问，内网API域名用于同区域（含VPC）环境访问，两者均支持HTTPS协议。
workspace_name：工作空间名称，例如default。
service_id：系统内置服务id，例如ops-object-detect-001。

请求参数

Header参数

API-KEY认证

参数	类型	必填	描述	示例值
Content-Type	String	是	请求类型：application/json	application/json
Authorization	String	是	API-Key	Bearer OS-d1**2a

Body参数

参数

类型

必填

描述

示例值

service_id

String

是

服务ID，以“ops-”开头。

ops-object-detect-001

image

Object

是

待识别的图片，可以通过以下参数指定图片信息，两个参数二选一：

url：可被访问的图片url地址。
content：指明文件的内容，用Base64Encode编码。

{
 "url":"http://1.jpg"
}

返回参数

参数	类型	描述	示例值
request_id	String	系统对一次API调用赋予的唯一标识。	A5B25952-4406-45BF-99EC-E8020246****
latency	Float/Int	请求耗时，单位ms。	10
usage.image	Int	图片的数量。	1
result.objects	List<ImageObject>	图片主体识别结果。	`[ { "confidence":80, "location": { "X" : 228, "Y" : 240, "height" : 430, "width" : 678 } } ]`

ImageObject

参数	类型	描述	示例值
confidence	Float	置信度（0~100），越高越可信	0.1644
location	Object	主体的位置信息
location.width	Integer	主体宽度，单位像素	176
location.height	Integer	主体高度，单位像素	188
location.Y	Integer	主体左上角垂直坐标。	560
location.X	Integer	主体左上角水平坐标。	37

Curl请求示例

curl --location 'http://****-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/image-object-detection/ops-object-detect-001/' \
--header 'Authorization: Bearer 您的API-KEY' \
--header 'Content-Type: application/json' \
--data '{
    "image":
    {
      "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250408/syuvxh/%E7%89%A9%E4%BD%93%E5%AE%9A%E4%BD%8D.png"
    }
}'

响应示例

正常响应示例

{
  "request_id": "138611ad4a03f620a1cdb2904768d286",
  "latency": 216,
  "usage": {
    "image": 1
  },
  "result": {
    "objects": [
      {
        "confidence": 0.4017,
        "location": {
          "width": 176,
          "height": 188,
          "X": 37,
          "Y": 560
        }
      },
      {
        "confidence": 0.3805,
        "location": {
          "width": 191,
          "height": 200,
          "X": 133,
          "Y": 752
        }
      },
      {
        "confidence": 0.3290,
        "location": {
          "width": 175,
          "height": 183,
          "X": 359,
          "Y": 663
        }
      },
      {
        "confidence": 0.2955,
        "location": {
          "width": 984,
          "height": 897,
          "X": 16,
          "Y": 8
        }
      },
      {
        "confidence": 0.2613,
        "location": {
          "width": 172,
          "height": 174,
          "X": 516,
          "Y": 559
        }
      },
      {
        "confidence": 0.2573,
        "location": {
          "width": 360,
          "height": 228,
          "X": 665,
          "Y": 704
        }
      },
      {
        "confidence": 0.2419,
        "location": {
          "width": 139,
          "height": 170,
          "X": 248,
          "Y": 388
        }
      },
      {
        "confidence": 0.1644,
        "location": {
          "width": 173,
          "height": 205,
          "X": 815,
          "Y": 507
        }
      },
      {
        "confidence": 0.1134,
        "location": {
          "width": 140,
          "height": 122,
          "X": 440,
          "Y": 446
        }
      }
    ]
  }
}

状态码说明

请参见AI搜索开放平台状态码说明。