需在火山引擎控制台确认并配置联网问答Pro版或Lite版，二者调用限额、高阶能力及参数权限不同，未实名认证无法开通；Pro版支持拍题答疑、图搜模式及更多搜索结果，Lite版强行传入Pro参数将返回403错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在火山引擎控制台为不同业务场景配置联网问答Pro版与Lite版，避免因参数混淆导致调用失败或额度超支。
确认当前开通的版本类型
登录火山引擎控制台 → 进入「智能体服务」→ 点击「联网问答Agent」卡片 → 查看右上角显示的版本标识：若显示“Pro”则已开通Pro版；若显示“Lite”则为Lite版。未开通任一版本时，该卡片不会出现在列表中。
【必须先完成实名认证】未完成企业/个人实名认证的账号无法开通任何版本，控制台将直接隐藏开通入口。
Lite版与Pro版核心参数差异
Lite版每月限1.8万次API调用，不支持多图多题、拍题答疑等高阶能力；Pro版调用次数为Lite版的5倍（即9万次/月），且独占以下三项参数权限：
- extension_options.learn_mode=auto_learning（仅Pro版支持拍题答疑场景）
- vision_config.enable=true（仅Pro版开放图搜模式）
- web_search.max_results=20（Lite版固定为10，不可修改）
以上三项参数若在Lite版请求中强行传入，接口将返回403错误并拒绝响应。
配置联网搜索触发策略
进入「联网问答Agent」→「对话配置」→「联网搜索」模块，按需选择：
方法一：总是开启
适用于市场动态监控、竞品活动追踪等强时效性场景。开启后每次请求均自动触发联网检索，【会100%消耗Token配额】，Lite版用户慎选。
方法二：按需开启
由大模型自主判断是否需要联网。仅当对话中出现“最新”“今天”“刚刚发布”等时效关键词，或用户提问涉及演员实时作品、政策文件号等需验证信息时才触发。该模式下Lite版与Pro版行为一致，但Pro版返回结果更完整（含结构化HTML报告）。
API调用时的版本识别逻辑
第一步：检查请求Header中是否携带X-Volc-Api-Key
第二步：校验该Key绑定的套餐类型（Lite/Pro）
第三步：解析body中extension_options字段是否存在learn_mode或vision_config子项
第四步：若存在且为Lite版Key，则立即拦截并返回code=403，message="Invalid parameter for Lite plan"
这一步无需手动干预，系统全自动执行。开发者只需确保Key与业务需求匹配即可。
