v1

latestOpenAPI 3.0.1ZHIPU AI 开发者协议和政策2026-07-2649130210.9 KB

知识库 API

全模态知识库检索

用于检索全模态知识库，支持文本、图片、视频等多模态输入检索，支持向量检索、关键词检索、混合检索，支持查询重写、重排、QA干预等高级功能。点击 Try it 按钮可快速试用。

post/zrag/retrieval/retrieve

multimodalboolean

是否走多模态路径检索，默认值为true

querystring

文本查询内容，与多模态查询内容必须传入其中之一

top_kinteger

最终召回数量，默认为8

top_ninteger

初始召回数量，默认为10

recall_method'embedding' | 'keyword' | 'mixed'

文本检索方式：embedding（向量检索）、keyword（关键词检索）、mixed（混合检索）

recall_rationumber

混合检索中向量检索的权重，取值范围0~1

enable_rerankboolean

是否开启重排，默认不开启

enable_rewriteboolean

是否开启查询重写，可配合messages参数实现多轮对话改写，默认不开启

enable_expansionboolean

是否开启扩召，默认不开启

similarity_thresholdnumber

相似度阈值，低于该阈值的切片会被过滤

业务处理成功

codeinteger

错误码，200为成功

messagestring

错误信息