火山引擎豆包API关闭联网搜索参数配置

需禁用联网搜索功能，方法有三：一是在请求体中设enable_search为false（小写布尔值）；二是用环境变量DOUBAO_ENABLE_SEARCH="false"统一控制；三是在火山方舟控制台关闭「豆包搜索抵扣开关」。

需要在调用火山引擎豆包API时禁用联网搜索功能，避免模型返回实时网络结果、防止意外触发搜索配额消耗、确保响应完全基于模型自身知识作答。

通过请求参数关闭联网搜索

在HTTP POST请求体中，将enable_search字段显式设为false：

{"query":"2026年最新个税起征点是多少","enable_search":

,"model":"doubao-seed-2-0-pro-260215"}

该参数为布尔值，必须小写，不可写成字符串"false"或数字0；若缺失此字段，系统默认启用联网搜索。

使用环境变量统一控制（推荐）

在Python工程中，通过os.environ设置开关，避免每次构造请求体都手动修改：

import os
os.environ["DOUBAO_ENABLE_SEARCH"] = "false"

后续所有调用封装函数读取该环境变量并自动注入请求体，可防止遗漏配置。若同时存在请求体字段与环境变量，以请求体字段为准。

在火山方舟控制台关闭全局联网能力

首先，登录火山方舟控制台，进入「Agent Plan」，点击左侧的「使用配置」；
其次，找到「豆包搜索抵扣开关」，将其状态切换为

；
最后，保存配置。此后，该账号下所有通过Agent Plan专属API Key发起的请求，即使未传enable_search参数，也将默认不触发联网搜索。

注意：此操作影响整个主账号ID维度下的所有调用，且每月500次免费额度将不再被消耗。