QueryRecommendation - 猜你想搜接口--Viking AI 搜索-火山引擎

文档中心

Viking AI 搜索

API参考

QueryRecommendation - 猜你想搜接口

说明

Viking AI 搜索是一款基于生成式 AI 的企业级 AI 搜索产品，基于大模型的多模态语义表征和理解能力，结合字节跳动信息检索领域多年最佳实践，为客户提供开箱即用的 AI 搜索搭建平台服务，帮助客户轻松搭建和集成端到端的多模态图文搜索和推荐能力。
想要体验更多 Viking AI 搜索能力，点击前往：Viking AI 搜索引擎，企业搜推问一体化智能引擎

不依赖用户输入 query 前缀，根据用户的个性化兴趣、搜索词热度等信息，推荐搜索词列表，主要适用于搜索框底纹词轮播、猜你想搜榜单等业务场景。

请求说明

请求地址：https://aisearch.cn-beijing.volces.com/api/v1/application/${application_id}/search/${scene_id}/query_recommendation

其中，${scene_id}是搜索的策略id，search_recommendation 后缀标识该API为猜你想搜API。

鉴权方式

可使用API Key或Access Key鉴权，详情参考API 鉴权机制说明

请求参数

请求体

参数	类型	是否必选	示例值	描述
user	User	`必选`	'user_xxxx'	用户信息用于明确是哪位用户触发了本次 API 调用。
page_size	Integer	`非必选`	5	配置最高返回数量如未传入，则使用当前策略在控制台中配置的返回数量。不支持分页，返回结果为单批次。说明:返回数量不一定等于 `page_size`参数。若在去重和过滤后，可推荐的query数量少于 `page_size`，返回数量可能会少过配置。默认值是5。
min_length	Integer	`非必选`	2	配置可接受的 query 字符长度最小值如未传入，则使用当前策略在控制台中配置的限制。默认值是2。
max_length	Integer	`非必选`	10	配置可接受的 query 字符长度最大值如未传入，则使用当前策略在控制台中配置的限制。默认值是10。
related_item	String	`非必选`	'400408'	父物品 id 当需要基于某个物品推荐与其相关的搜索词时，需要传入该物品的唯一标识。
dataset_id	String	`部分必选`	'38759234'	父物品的数据集 id 当有传入父物品id时，必须同时传入父物品所在的数据集id，否则无法基于父物品推荐相关的搜索词

返回参数

参数	类型	示例值	描述
request_id	String	`"25ee998a-5462-9385-9f18-035f1da7a6e5"`	请求 ID 一次请求的唯一标识，支持快速定位到一次请求。
recommendation_queries	Array	`{ "recommendation_queries":[ {"query":"adizero训练跑鞋"}, {"query":"运动短裤ftshorts"}, {"query":"fitted运动t恤"} ] }`	推荐的query列表

请求示例

直接推荐搜索词

curl -X POST 'https://aisearch.cn-beijing.volces.com/api/v1/application/${application_id}/search/${scene_id}/query_recommendation' \
  -H 'Content-Type: application/json' \
  -H 'X-Account-Id: account_id' \   //此处入参account_id
  -H 'Authorization: Bearer <API Key>' \
  -d '{
  "user": { 
        "_user_id": ""
     }, 
  "page_size":
  "min_length": ""
  "max_length": ""
  "related_item": ""
  "dataset_id": ""
}'

根据物品推荐相关搜索词

curl -X POST 'https://aisearch.cn-beijing.volces.com/api/v1/application/${application_id}/search/${scene_id}/query_recommendation' \
  -H 'Content-Type: application/json' \
  -H 'X-Account-Id: account_id' \  //此处入参account_id
  -H 'Authorization: Bearer <API Key>' \
  -d '{
  "user": { 
        "_user_id": ""
     }, 
  "page_size": 
  "min_length": "" 
  "max_length": ""
  "related_item": ""
  "dataset_id": "" 
}'

最近更新时间：2026.04.29 12:16:41

这个页面对您有帮助吗？

有用

无用

Viking AI 搜索

请求说明 #

鉴权方式 #

请求参数 #

请求体 #

返回参数 #

请求示例 #

直接推荐搜索词 #

根据物品推荐相关搜索词 #