在体验配置界面进行搜索策略的配置和效果测试后，您可以通过控制台生效配置到在线搜索引擎，然后通过接口将配置好的AI 搜索场景集成至您的平台。

在 应用 > 体验配置 > 搜索体验 右侧配置栏中，点击**【生效当前配置】​**即可将配置生效至正式接口调用的在线引擎。生效后可开始集成搜索接口，将AI 搜索能力集成至您的平台。

按照以下说明调用搜索API

curl -X POST 'https://aisearch.cn-beijing.volces.com/api/v1/application/application_id}/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer API key' \
  -d '{
    "query": {
        "text": query文本字符串
        "image_url"：image文件
        "image_query_instruction": 图片检索指令
        },
    "dataset_id": 指定的数据集ID
    "page_number": 搜索页码，从 1 开始,
    "page_size": 每页搜索结果的数量,
    "user": {
        "user_id": 用户ID
        },
    "context":{
        "location":地理位置对象
    }
    "filter": 搜索过滤条件
    "sort_by": 指定的排序字段
    "sort_order": 排序顺序
}'

application_id：您创建的应用ID
query文本字符串：用字符串的形式传入用户输入的query文本
image文件：用base64的形式传入用户上传的，用于图片搜索的图片
搜索页码：搜索页码，可用于列表分页功能，必传项，从 1 开始
每页搜索结果的数量：搜索每页的数据量，必传项
用户ID：上传此次调用对应的用户ID，非必传项，建议上传。
地理位置对象：使用JSON对象上传用户地理位置，例如{"latitude": "12.1243","longitude": "-012.1223"}
搜索过滤条件：JSON对象格式的过滤语句，在搜索时对召回的物品数据进行过滤筛选，使用前请确认被过滤的字段已经在应用配置中配置为了可筛选字段。过滤在API参数中的传入方式见：在搜索时过滤
指定的排序字段&排序顺序：指定物品数据集的字段作为搜索列表排序的依据，非必传，使用方法详见：对搜索返回列表进行排序
指定的**数据集ID: 您创建的数据集ID，必传项

使用文本搜索

当用户在搜索框输入文本时，将用户输入的文本传入 query.text字段。

参数说明

query.text

参数类型：String
参数含义：​用户输入的query文本内容

调用示例

curl -X POST 'https://aisearch.cn-beijing.volces.com/api/v1/application/your_app_id/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <API Key>' \
  -d '{
    "query": {
        "text": "适合雨季登山的运动鞋"
     },
    "user_id":"u89001829UXHKS",
    "context":{
        "location":{
            "latitude": "12.1243",
            "longitude": "-012.1223"
        }
    }
    "dataset_id": "106265704",
    "page_number": 1,
    "page_size": 50,
}'

使用图片搜索

您可以在 query.image 中传入base64格式的图片文件进行图片搜索。

参数说明

query.image_url

参数类型：String
参数含义：​用户输入的图片内容，以Base64格式的字符串传入
参数说明：
上传图片数据时，您必须上传符合以下说明中格式和限制的图片文件，AI 搜索引擎才可以对图片进行处理并进行图片搜索：

请确保Base64编码符合标准格式，包含数据头（Data URI Scheme）​与 Base64 编码正文两部分：

data:<MIME类型>;base64,<Base64编码字符串>

data:image/jpeg;base64,<Base64编码字符串>

data:image/png;base64,<Base64编码字符串>

data:image/webp;base64,<Base64编码正文>

query.image_query_instruction

参数类型：String
参数含义：​一段文本的图片搜索指令，可以理解为为模型提供一个“如何匹配query图片和候选图片”的指导。可在特定的图片搜索场景下采用一个固定的指令来提升检索的准确性。
参数说明：
目前验证有效的图片搜索指令覆盖相同图片搜索、相似商品搜索和相似素材搜索
以下是我们结合内部测试与实际应用场景，为您总结的一些最佳实践指令，供您参考：

搜索相似图片：基于图片的整体内容召回相似的图片，而不是仅关注图片中的局部信息
搜索相同图片：查找与本图完全相同的图片，可能经过了ps处理，包含缩放、裁剪和水印，请忽略PS处理痕迹
搜索同款商品：忽略背景以及人物主体并查找这张图片中出现的同款商品图片

调用示例

电商图搜场景：传入一张图片进行搜索

curl -X POST 'https://aisearch.cn-beijing.volces.com/api/v1/application/your_app_id/search' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <API Key>' \
  -d '{
    "query": {
        "image_url":<Base64格式的图片文件>
        "image_query_instruction":"忽略背景以及人物主体并查找这张图片中出现的同款商品图片"
    },
    "dataset_id": "106265704",
    "page_number": 1,
    "page_size": 50,
}'