文档中心

Viking AI 搜索

搜索接口

QueryCompletion - 搜索补全

说明

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

对搜索词进行联想，根据输入的部分搜索词，返回对搜索词进行联想后的查询词。

请求说明

服务	区域	URL
火山引擎	华北(北京)	https://aisearch.cn-beijing.volces.com/api/v1/application/{application_id}/search/{scene_id}/query_completion
火山引擎	东南亚(柔佛)	https://aisearch.ap-southeast-1.volces.com/api/v1/application/{application_id}/search/{scene_id}/query_completion
BytePlus	东南亚(柔佛)	https://aisearch.ap-southeast-1.bytepluses.com/api/v1/application/{application_id}/search/{scene_id}/query_completion

{application_id}：在控制台创建应用后系统指定的应用唯一标识，可在控制台查看

{scene_id}：即搜索策略id，在控制台体验配置页面新建搜索策略后，系统指定的策略唯一标识，用户可在控制台「搜索体验」— 鼠标悬停策略名称 — 复制策略 ID。

鉴权方式

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

请求参数

请求体

参数	类型	是否必选	示例值	描述
query	String	是	"在海边"	待联想的查询词，输入查询词的长度需要大于等于在应用中配置的最小联想字符数。

响应参数

请求响应

参数	类型	示例值	描述
request_id	String	25ee998a-5462-9385-9f18-035f1da7a6e5	用于唯一标识一次请求，可根据request_id快速定位一次请求的执行。
result	Result	见下方：Result	搜索联想结果

数据结构

Result

参数	类型	示例值	描述
suggestions	Array of Suggestion	见下方：Suggestion	搜索联想结果列表，默认返回10条，如需调整可在应用配置中搜索联想的最大查询召回量。

Suggestion

参数	类型	示例值	描述
suggestion	String	"在海边露营"	单条搜索联想词

请求示例

响应示例

错误处理

错误码

本接口错误码请参见公共错误码文档。

说明

想要体验更多 Viking AI 搜索能力，点击前往：Viking AI 搜索引擎，企业搜推问一体化智能引擎

最近更新时间：2026.06.03 19:37:07

这个页面对您有帮助吗？

有用

无用