主體識別 - OpenSearch

支援從映像中自動檢測並識別一個或多個主要目標，適用於智能監控、自動駕駛、映像檢索等典型電腦視覺應用情境。

服務名稱	服務ID	服務描述	API調用QPS限制（含主帳號與RAM子帳號）
主體識別服務	ops-object-detect-001	由阿里雲 OpenSearch-AI 團隊自研多主體檢測模型，可檢測圖片中多個獨立主體，輸出主體位置框及置信分。可用於複雜情境中主體提取，作為下遊任務的輸入，可排除圖片背景或其他主體對下遊embedding和rerank模型的幹擾。	20 說明如需擴充QPS，請通過工單聯絡支援人員協助。

Face Service服務	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搜尋開放平台狀態代碼說明。