火山引擎联网问答会话API请求参数配置示例

调用火山引擎联网问答API前，需正确配置参数，包括公共请求参数和接口特定参数，否则将返回400或限流。公共请求参数可参考公共参数文档，接口特定参数需查阅各接口参数描述。同时，还需创建并安全存储AccessKey，用HMAC-SHA256签名，且时间戳偏差需≤300秒。请求体必须包含model、messages、enable_web_search参数，其中model须选择最新版本。请求头需设置Content-Type、X-App-ID和Authorization签名，Authorization签名可参考火山引擎OpenAPI签名方法文档。

调用火山引擎联网问答会话API前，必须正确配置请求参数，否则会返回400错误或触发限流，导致无法获取实时网页搜索结果。

准备认证凭证

第一步：登录火山引擎控制台 → 进入「访问密钥」页面 → 创建一对新的AccessKey ID和AccessKey Secret。

第二步：将生成的AccessKey ID和AccessKey Secret保存至安全环境变量中，

。泄露会导致账户被恶意调用并产生不可控费用。

第三步：使用该AccessKey对请求头进行签名，签名算法必须为HMAC-SHA256，时间戳需精确到秒且与服务器时间偏差不超过300秒。

构造基础请求体

方法一：最小必要字段组合

{"model": "ep-2024110101", "messages": [{"role": "user", "content": "今天北京天气如何？"}], "enable_web_search": true}

方法二：带搜索控制的完整字段

{"model": "ep-2024110101", "messages": [{"role": "user", "content": "对比特斯拉Model Y和小鹏G6的续航与售价"}], "enable_web_search": true, "web_search_config": {"search_region": "zh-CN", "max_results": 5}}

注意：model值必须从火山引擎文档最新列表中选取，旧模型如ep-2024090101已下线，调用会直接返回404。

设置关键请求头

Content-Type: application/json；必须显式声明，缺失将导致解析失败。

X-App-ID: your_app_id；该ID在创建应用时自动生成，位于「AI服务→应用管理」页面，

。

Authorization: HMAC-SHA256 Credential=xxx/20241105/cn-north-1/ark/ecs_request, SignedHeaders=content-type;host;x-app-id;x-date, Signature=xxx；签名串中x-date格式为YYYYMMDDTHHMMSSZ（UTC时间），错一位字符即验签失败。