從媒體集中搜索與指定圖片或人臉ID最相似的前N張圖片，并返回相應人臉ID及邊界框，返回結果按照相似度降序排列。
接口說明
-
此接口已不再維護，建議使用新版（2020-09-30 版本）接口 CreateFacesSearchingTask 。關于新版與舊版 API 的對比，請參見新舊版本使用指引中的新版與舊版 API 對應關系說明章節。
-
您可以使用如下兩種方式從媒體集中搜索與人臉最相似的前 N 張圖片。
-
通過傳入媒體集中人臉 ID 進行搜索，具體步驟如下：
說明 返回值中 Faces 的首個元素一定是傳入的 FaceId，系統不會對結果進行過濾。-
調用 CreateSet 接口創建媒體集。
-
調用 IndexImage 接口將圖片索引到媒體集。
-
調用 ListImages 或 GetImage 接口獲取需要進行搜索的人臉 ID。
-
使用媒體集中的人臉 ID，將人臉 ID 作為輸入值，從媒體集中搜索與人臉 ID 對應人臉最相似的前 N 張圖片。
-
通過傳入圖片的 OSS URI 進行搜索，具體步驟如下：
說明 當傳入的 ImageUri 在媒體集中存在時，則返回值中 Faces 的首個元素一定是傳入的 ImageUri 內的同一個人臉，系統不會對結果進行過濾。- 將圖片上傳到 OSS。
- 使用圖片的 OSS URI，將圖片中的人臉作為輸入值，從媒體集中搜索與圖片中人臉最相似的前 N 張圖片。
-
-
當兩個人臉的相似度 Similarity>0.8 時，兩個人臉基本可以判斷為同一人物。
-
搜索結果依賴索引的建立，返回結果與實際值可能有數秒的數據延遲。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Project | string | 是 | 項目名稱。 | immimagetest |
| SetId | string | 是 | 媒體集的唯一標識。 | set001 |
| ImageUri | string | 是 | 圖片的 OSS URI。 OSS 地址規則為 | oss://imm-test/testcases/face1.jpg |
| FaceId | string | 否 | 媒體集中已存在的人臉 ID。 | 59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51 |
| Limit | integer | 否 | 返回最相似圖片的最大個數，默認值為 10，取值范圍為 1~100。 | 5 |
| MinSimilarity | float | 否 | 過濾返回結果中相似度低于該值的圖片。 | 0.8 |
| ResponseFormat | string | 否 | 返回值的格式版本，不設置此參數則返回值的格式為舊版本，推薦設置此參數為 v2。 | v2 |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "31A201C4-6824-4A8F-81FE-E0659FDDF1D7",
"Faces": [
{
"FaceId": "59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a0406a51",
"ImageUri": "oss://imm-test/testcases/face1.jpg",
"ExternalId": "external001",
"FaceAttributes": {
"FaceBoundary": {
"Top": 191,
"Width": 269,
"Height": 252,
"Left": 95
}
},
"Similarity": 0.860930573940277,
"SimilarFaces": [
{
"FaceId": "98ae3c032337161f997a92f8ab9ac9624113368b9e4f93f6143d54a16e51b623",
"ImageUri": "oss://imm-test/testcases/face3.jpg",
"ExternalId": "external003",
"FaceAttributes": {
"FaceBoundary": {
"Top": 152,
"Width": 139,
"Height": 141,
"Left": 267
}
},
"Similarity": 0.860930573940277
}
]
}
]
}錯誤碼
訪問錯誤中心查看更多錯誤碼。