必须先完成认证配置与请求参数正确组装，否则返回401或403错误；需获取api key或accesskey（ak/sk），按方式设置url、header（servicename必须为ask_echo）及json请求体（必填query，mode、search_type等字段需严格合规）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在项目中调用火山引擎联网问答Collab版API获取带参考资料的智能体回复，必须先完成认证配置与请求参数的正确组装，否则会返回401或403错误。
准备API密钥与服务凭证
登录火山引擎控制台→进入「访问密钥」页面→点击「创建AccessKey」→填写描述并确认创建→页面立即显示AK（Access Key ID）和SK（Secret Access Key）；【SK仅显示一次，请立即复制保存，丢失后无法找回】。
若使用API Key方式接入，需前往「联网问答Agent」控制台→「应用管理」→「新建应用」→获取专属API Key；该Key绑定具体应用，不可跨项目复用。
选择接入方式并构造请求URL
方法一：API Key接入（推荐测试阶段使用）
直接使用固定URL：https://open.feedcoopapi.com/agent_api/agent/collab，无需拼接参数。
方法二：Access Key接入（生产环境强制要求）
URL必须严格按格式构造：https://mercury.volcengineapi.com?action=agentcollab&version=2026-01-01；【version参数值必须为2026-01-01，填错将返回InvalidParameter】。
两种方式不可混用——若传了access key又在header里放了API Key，系统以access key为准，但签名逻辑仍按API Key方式校验，必然失败。
设置请求Header
第一步：确定认证类型后，只保留对应的一组Header字段，删掉另一组全部字段。
第二步：API Key方式需设置三项：
Authorization: bearer
Content-Type: application/json
ServiceName: ask_echo
第三步：Access Key方式只需两项：
Content-Type: application/json
ServiceName: ask_echo
注意：Access Key方式不传Authorization头，签名通过X-Amz-SignedHeaders、X-Amz-Signature等query参数传递，由SDK自动注入。
这一步最容易出错的是把ServiceName写成ask_echo_v2或ask-collab——必须一字不差填ask_echo，否则鉴权直接拒绝。
构造合法JSON请求体
① 最小必填字段只有query，例如：{"query":"今天北京天气怎么样"}。
② 若需启用深度思考模式，必须显式添加"mode": "deep_thinking"字段；不加则默认走Lite版流程，即使你已开通Pro版也不生效。
③ 指定搜索类型时，search_type可选"web"（网页）、"image"（图片），但不能同时指定；填错值如"img"会导致整个请求被拦截，返回400且无详细错误提示。
④ 所有字符串字段值必须为UTF-8编码，中文直接写，不要urlencode；但query中若含换行符，必须替换为\n，否则解析失败。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
