/similar 路由使用 AI 驱动的搜索返回与目标文档相似的多个文档。 Meilisearch 暴露了两个用于检索相似文档的路由：POST 和 GET。在大多数情况下，POST 将提供更好的性能和易用性。

​
使用 POST 获取相似文档

POST
/indexes/{index_uid}/similar
检索与特定搜索结果相似的文档。

​
路径参数

名称类型描述
index_uid *字符串请求索引的 uid

​
请求体

参数类型默认值描述
id字符串或数字null目标文档的标识符（必填）
embedder字符串null计算推荐时使用的嵌入器。必填
attributesToRetrieve字符串数组["*"]在返回的文档中显示的属性
offset整数0要跳过的文档数量
limit整数20返回的最大文档数量
filter字符串null按属性值筛选查询
showRankingScore布尔值false显示文档的全局排名得分
showRankingScoreDetails布尔值false显示详细的排名分数信息
rankingScoreThreshold数字null排除排名分数低的搜索结果
retrieveVectors布尔值false返回文档向量数据

​
示例

curl \
  -X POST 'MEILISEARCH_URL/indexes/INDEX_NAME/similar' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer DEFAULT_SEARCH_API_KEY' \
  --data-binary '{
    "id": TARGET_DOCUMENT_ID,
    "embedder": "EMBEDDER_NAME"
  }'

​
响应：200 OK

{
  "hits": [
    {
      "id": "299537",
      "title": "Captain Marvel"
    },
    {
      "id": "166428",
      "title": "How to Train Your Dragon: The Hidden World"
    }
    {
      "id": "287947",
      "title": "Shazam!"
    }
  ],
  "id": "23",
  "processingTimeMs": 0,
  "limit": 20,
  "offset": 0,
  "estimatedTotalHits": 3
}

​
使用 GET 获取相似文档

GET
/indexes/{index_uid}/similar
检索与特定搜索结果相似的文档。

​
路径参数

名称类型描述
index_uid *字符串请求索引的 uid

​
查询参数

参数类型默认值描述
id字符串或数字null目标文档的标识符（必填）
embedder字符串"default"计算推荐时使用的嵌入器。必填
attributesToRetrieve字符串数组["*"]在返回的文档中显示的属性
offset整数0要跳过的文档数量
limit整数20返回的最大文档数量
filter字符串null按属性值筛选查询
showRankingScore布尔值false显示文档的全局排名得分
showRankingScoreDetails布尔值false显示详细的排名分数信息
rankingScoreThreshold数字null排除排名分数低的搜索结果
retrieveVectors布尔值false返回文档向量数据

​
示例

curl \
  -X GET 'MEILISEARCH_URL/indexes/INDEX_NAME/similar?id=TARGET_DOCUMENT_ID&embedder=EMBEDDER_NAME'

​
响应：200 OK

{
  "hits": [
    {
      "id": "299537",
      "title": "Captain Marvel"
    },
    {
      "id": "166428",
      "title": "How to Train Your Dragon: The Hidden World"
    }
    {
      "id": "287947",
      "title": "Shazam!"
    }
  ],
  "id": "23",
  "processingTimeMs": 0,
  "limit": 20,
  "offset": 0,
  "estimatedTotalHits": 3
}
© . This site is unofficial and not affiliated with Meilisearch.