search_type参数必须配置正确，其合法取值为text、multimodal、auto：text强制进行纯文本检索；multimodal需携带image或video_frame且已开通权限；auto则由服务端自动路由。

要在火山引擎联网问答中精确控制搜索行为，必须正确配置search_type参数。

否则，大模型可能调用错误的检索通道，导致返回结果缺失图片、无法解析视频帧或漏掉结构化数据。

明确 search_type 的可选值及适用场景

search_type 是联网搜索请求体中的关键字段，决定底层调用的是纯文本检索、多模态检索还是混合策略。

它不参与自然语言理解，只影响执行路径。

目前仅支持三个合法值：【text】、【multimodal】、【auto】。

传入其他字符串（如 "image"、"video"、"hybrid"）将直接触发 400 错误并中断请求。

• text：强制走纯文本通道，忽略所有图像/视频输入，适合已知用户只问天气、新闻、政策等纯文字问题的场景。
• multimodal：强制启用视觉理解模块，这要求请求中必须带有base64编码的image字段或者video_frame字段，要是没有的话，就会返回400错误；如果VisionConfig.Enable没有开启，那么这个值会被悄悄地降级为text。
• auto：由服务端自动路由，根据输入内容判断走 text 还是 multimodal。

在 Responses API 中配置 search_type

调用火山引擎 Responses API 时，search_type 必须放在 ParamsString 内部 JSON 的顶层。

不能嵌套在 Config 或其他子对象里。

配置步骤

• 第一步：确认你使用的 bot_id 已在控制台开通 multimodal 权限。未开通时即使传入 multimodal，也会被服务端拦截并返回错误码 403。
• 第二步：构造 ParamsString，示例如下：

{"bot_id":"your_bot_id","stream":true,"search_type":"multimodal"}

• 第三步：将上述 ParamsString 作为 URL 编码后的字符串，填入 Responses API 请求体的 params_string 字段，再发起 POST 请求。

注意：search_type 的值必须是小写字符串，且前后不能有空格。

大写如 "Multimodal" 或带引号如 '"multimodal"' 均会导致解析失败。

按业务类型选择 search_type 的方法

• 方法一：纯时效问答类（如查股价、问赛事比分、搜最新政策）→ 固定设为 【text】
• 方法二：AI视频陪看类（用户上传剧照问“这个演员是谁”或“她最近播了什么剧”）→ 必须设为 【multimodal】，且确保请求中含 image 字段
• 方法三：通用对话 Agent（无法预判用户是否发图）→ 设为 【auto】，由服务端根据输入内容自动路由：有图走 multimodal，无图走 text

《夸克》非常好用的免费AI浏览器

下载APP查看