必须正确配置search_type参数,其合法值为text、multimodal、auto:text强制纯文本检索;multimodal需携带image或video_frame且已开通权限;auto由服务端自动路由。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在火山引擎联网问答中精确控制搜索行为,必须正确配置search_type参数,否则大模型可能调用错误的检索通道,导致返回结果缺失图片、无法解析视频帧或漏掉结构化数据。
明确 search_type 的可选值及适用场景
search_type 是联网搜索请求体中的关键字段,决定底层调用的是纯文本检索、多模态检索还是混合策略。它不参与自然语言理解,只影响执行路径。
目前仅支持三个合法值:【text】、【multimodal】、【auto】。传入其他字符串(如 "image"、"video"、"hybrid")将直接触发 400 错误并中断请求。
text:强制走纯文本通道,忽略所有图像/视频输入,适合已知用户只问天气、新闻、政策等纯文字问题的场景。
multimodal:强制启用视觉理解模块,要求请求中必须携带 base64 编码的 image 字段或 video_frame 字段,否则返回 400;若未开启 VisionConfig.Enable,该值会被静默降级为 text。
在 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"}
注意:search_type 的值必须是小写字符串,且前后不能有空格。大写如 "Multimodal" 或带引号如 '"multimodal"' 均会导致解析失败。
第三步:将上述 ParamsString 作为 URL 编码后的字符串,填入 Responses API 请求体的 params_string 字段,再发起 POST 请求。
按业务类型选择 search_type 的方法
方法一:纯时效问答类(如查股价、问赛事比分、搜最新政策)→ 固定设为 【text】
方法二:AI视频陪看类(用户上传剧照问“这个演员是谁”或“她最近播了什么剧”)→ 必须设为 【multimodal】,且确保请求中含 image 字段
方法三:通用对话 Agent(无法预判用户是否发图)→ 设为 【auto】,由服务端根据输入内容自动路由:有图走 multimodal,无图走 text











