图片搜索-云原生数据仓库AnalyticDB(AnalyticDB)-阿里云帮助中心

AnalyticDB for MySQL 图片搜索服务提供以图搜图、以文搜图和标签过滤能力，支持构建电商商品检索、内容推荐、安防识别等视觉搜索场景。

重要

图片搜索功能当前处于邀测中。如需使用，请提交工单或联系技术支持开通。

核心特性

图片搜索服务提供三种工作模式，适配不同业务场景。创建图片库时需指定工作模式，创建后不可更改。

模式	适用场景	核心能力
物品搜索（`item_search`）	电商商品检索、服装设计	自动识别并提取指定物品的 embedding，实现精准物品匹配。
通用搜索（`general_search`）	内容推荐、图库管理	整图语义 embedding，同时支持以图搜图和以文搜图。
自适应检索（`adaptive_search`）	安防监控、身份识别	双路特征提取：人脸图片优化人脸特征，非人脸图片切换全图语义。

说明：图片搜索服务在导入和检索时自动将图片或文本转化为高维数值向量（embedding），通过向量相似度计算实现语义匹配。无需自行调用 embedding 模型。

支持创建多个图片库，各图片库之间数据隔离，适用于多租户 SaaS 场景。

功能	说明
图片库管理	创建、查询和删除图片库。创建时需指定工作模式（物品搜索、通用搜索、自适应检索），创建后不可更改。
图片导入	将图片导入到图片库。支持单张同步导入和批量异步导入（通过 OSS JSONL 文件），可附带自定义标签用于后续过滤。
图片检索	在图片库中检索相似图片。以图搜图：以图片作为查询条件，在图片库中检索视觉上相似的图片。支持物品级精准匹配或整图语义匹配。以文搜图：输入文本描述（如“白色短袖T恤”），检索语义匹配的图片。支持多语言自动翻译。标签过滤：检索时支持基于自定义标签的复合过滤条件，支持 AND/OR 逻辑组合。

所有接口统一前缀：/api/v1/operators/image-search

所有接口返回统一 JSON 结构：

{
  "status": "SUCCESS",
  "message": null,
  "data": { ... }
}

字段	类型	说明
`status`	string	业务状态码。`"SUCCESS"` 表示成功，其他值表示具体错误类型。
`message`	string / null	状态描述信息。成功时为 `null`，失败时为具体错误原因。
`data`	object / null	业务数据。失败时为 `null`，部分成功接口的 data 也可为 `null`。

HTTP 状态码正常使用（200、400、403、404、409、500 等），用于粗粒度判断。响应体中的 status 和 message 提供细粒度的业务错误信息。

构建“拍照找同款”功能：用户上传商品照片，系统自动识别商品主体（如连衣裙、鞋子），在商品库中检索相似款式，并支持按颜色、尺码等标签进一步筛选。

内容平台个性化推荐：用户浏览某张图片时，系统提取图片语义特征，检索相似风格或主题的内容，结合用户画像进行个性化排序。

大型企业视觉资产管理：批量导入历史图片资源并附带标签分类，支持文字描述或样例图片检索，快速定位所需素材。

限制项	说明
工作模式	图片库创建后，工作模式不可更改。如需切换模式，需删除图片库后重新创建。
图片库数量	单个 AnalyticDB for MySQL 实例最多创建 5 个图片库。如需更多，请联系技术支持。
以文搜图	仅在 `general_search`（通用搜索）模式的图片库中可用。