如何使用 OpenAI CLIP 构建语义图像搜索#
本指南将带你使用 OpenAI CLIP 和 Flask 构建一个语义图像搜索引擎。通过将 CLIP 的视觉语言嵌入与由 NumPy 提供支持的快速余弦相似度搜索相结合,你可以构建一个能够根据自然语言查询检索相关图像的 Web 界面,无需任何标签或类别。
Watch: How Similarity Search Works | Visual Search Using OpenAI CLIP and the Ultralytics Package 🎉

Ultralytics Python 包将整个流程封装在两个类中,因此你只需几行代码即可启动可用的搜索应用或以编程方式运行查询。本指南涵盖为什么语义搜索很有用、它是如何工作的、运行网络应用、以编程方式搜索以及配置参数。
为什么使用语义图像搜索?#
使用 CLIP 构建你自己的语义图像搜索系统具有几个显著优势:
- **零样本能力:**你无需在数据集上进行训练。CLIP 的零样本学习允许你使用自由格式的自然语言查询任何图像集,从而节省时间和资源。
- 类人的理解力: 与关键词搜索不同,CLIP 可以理解语义上下文,并从抽象、情感或关系查询中检索图像,例如“自然中快乐的孩子”或“夜间充满未来感的城市天际线”。
- 无需标签或元数据: 这种方法仅需要原始图像。CLIP 无需任何手动标注即可生成 embeddings。
- 轻量且精确的搜索: 在 NumPy 中进行一次归一化矩阵乘法即可根据 cosine similarity 对每张图像进行排名,在数千个 embeddings 中提供实时响应的精确结果,且无需安装或管理额外的搜索依赖。
- 跨领域应用: 无论你是构建个人照片存档、创意灵感工具、产品搜索引擎还是艺术推荐系统,同一个技术栈都可以在最小程度的调整下进行适配。
语义图像搜索的工作原理#
该流程结合了三个组件,每个组件负责将图像和文本转换为排名结果的一个阶段:
- CLIP 使用用于图像的视觉编码器(例如 ResNet 或 ViT)和用于语言的文本编码器(基于 Transformer)将两者投影到相同的多模态嵌入空间中。这允许使用余弦相似度直接比较文本和图像。
- NumPy 将图像 embeddings 存储为一个数组,并通过一次矩阵乘法将其与查询 embedding 进行排名对比,从而按 cosine similarity 返回最接近的向量,无需额外的索引依赖。
- Flask 提供了一个简单的网页界面,用于提交自然语言查询并显示索引中语义匹配的图像。

因为图像和文本都处于同一个向量空间中,所以检索是零样本的:你不需要标签或类别,只需要图像数据和一个好的提示词。
运行语义搜索网页应用#
SearchApp 类用于启动完整的 Flask 界面。首次运行时,它会下载示例图像集,构建嵌入索引,并提供一个页面,供你输入查询并查看排序后的结果。
图像路径警告
如果你使用自己的图像,请确保提供图像目录的绝对路径。否则,由于 Flask 的文件服务限制,图像可能无法在网页上显示。
from ultralytics import solutions
app = solutions.SearchApp(
data="images", # replace with a path to build the search engine with your own images
device="cpu", # configure the device for processing, e.g., "cpu" or "cuda"
)
app.run(debug=False) # You can also use `debug=True` argument for testing以编程方式搜索图像#
VisualAISearch 类在没有 Web 层的情况下执行所有后端操作:
- 从本地图像加载或构建 embedding 索引。
- 使用 CLIP 提取图像和文本嵌入。
- 使用余弦相似度执行相似度搜索。
调用搜索器并传入自然语言查询,即可返回按相似度排名的匹配图像文件名列表:
from ultralytics import solutions
searcher = solutions.VisualAISearch(
data="images", # replace with a path to build the search engine with your own images
device="cpu", # configure the device for processing, e.g., "cpu" or "cuda"
)
results = searcher("a dog sitting on a bench")
# Ranked Results:
# - 000000546829.jpg | Similarity: 0.3269
# - 000000549220.jpg | Similarity: 0.2899
# - 000000517069.jpg | Similarity: 0.2761
# - 000000029393.jpg | Similarity: 0.2742
# - 000000534270.jpg | Similarity: 0.2680配置 VisualAISearch 参数#
下表概述了 VisualAISearch 的可用参数:
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
data | str | 'images' | 用于相似度搜索的图像目录路径。 |
| 参数 | 类型 | 默认值 | 描述 |
|---|---|---|---|
device | str | None | 指定用于推理的设备(例如 cpu、cuda:0 或 0)。允许用户在 CPU、特定的 GPU 或用于模型执行的其他计算设备之间进行选择。 |
要在生产规模下搜索图像集合而无需管理本地文件,你可以在使用 CLIP 建立索引之前,在 Ultralytics Platform 中组织和版本化你的图像。
结论#
借助 CLIP 和 Ultralytics Python 包,你只需几行代码即可建立零样本语义图像搜索引擎,既可以作为 Flask Web 应用,也可以作为程序化搜索后端。从这里开始,将 data 指向你自己的图像目录以对其建立索引,然后探索其他 Ultralytics Solutions 以在你的计算机视觉工作流之上进行构建。
常见问题解答#
CLIP 的出色之处在于其泛化能力。它不是仅针对特定标签或任务进行训练,而是从自然语言本身学习。这使它能够处理像“骑摩托艇的人”或“超现实梦境”这样的灵活查询,从而在分类到创意语义搜索等各种任务中发挥作用,无需重新训练。
虽然 CLIP 由 OpenAI 开发,但 Ultralytics Python 包将嵌入生成、索引和余弦相似度搜索包装成一个完整的语义图像搜索流程,只需几行即可正常工作的代码:
from ultralytics import solutions searcher = solutions.VisualAISearch( data="images", # replace with a path to build the search engine with your own images device="cpu", # configure the device for processing, e.g., "cpu" or "cuda" ) results = searcher("a dog sitting on a bench")这种高阶实现处理了:
- 基于 CLIP 的图像和文本 embedding 生成。
- Embedding 索引的创建与管理。
- 使用余弦相似度进行高效的语义搜索。
- 基于目录的图像加载和可视化。
可以。当前的设置使用 Flask 和基础 HTML 前端,但你可以用你自己的 HTML 替换它,或者用 React、Vue 或其他前端框架构建更动态的 UI。Flask 可以作为你自定义界面的后端 API。
不能直接搜索。一个简单的变通方法是从视频中提取单个帧(例如,每秒提取一帧),将它们视为独立的图像,然后将它们输入系统。这样,搜索引擎就可以语义化地索引你视频中的视觉片段。