Viking AI 搜索
Viking AI 搜索
Viking AI 搜索
文档指南
请输入
产品动态
AI搜索引擎用户手册
产品简介
用户指南
配置 AI 搜索
配置个性化推荐
去除重复推荐物品（去重）
干预推荐物品多样性
配置智能对话搜索（Agentic Search）
数据集
应用监控
最佳实践
API参考
数据API
OpenAPI
vaka 用户手册
快速入门
- 文档首页
Viking AI 搜索AI搜索引擎用户手册API参考搜索接口QueryRecommendation - 猜你想搜接口
复制全文
下载 pdfQueryRecommendation - 猜你想搜接口
文档反馈
问问助手Viking AI 搜索是一款基于生成式 AI 的企业级 AI 搜索产品，基于大模型的多模态语义表征和理解能力，结合字节跳动信息检索领域多年最佳实践，为客户提供开箱即用的 AI 搜索搭建平台服务，帮助客户轻松搭建和集成端到端的多模态图文搜索和推荐能力。
不依赖用户输入 query 前缀，根据用户的个性化兴趣、搜索词热度等信息，推荐搜索词列表，主要适用于搜索框底纹词轮播、猜你想搜榜单等业务场景。
请求说明
- 请求方式：POST
- 请求地址
- 服务区域URL服务区域URL火山引擎华北(北京)https://aisearch.cn-beijing.volces.com/api/v1/application/{application_id}/search/{scene_id}/query_recommendation火山引擎东南亚(柔佛)https://aisearch.ap-southeast-1.volces.com/api/v1/application/{application_id}/search/{scene_id}/query_recommendationBytePlus东南亚(柔佛)https://aisearch.ap-southeast-1.bytepluses.com/api/v1/application/{application_id}/search/{scene_id}/query_recommendation
- {scene_id}：在控制台创建应用后由系统指定的搜索唯一标识，可在控制台查看。
鉴权方式
请求参数
请求体
参数 | 类型 | 是否必选 | 示例值 | 描述 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
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<String> | { "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.08.08 18:09:14
这个页面对您有帮助吗？
有用
有用
无用
无用