火山引擎联网问答会话API请求参数配置示例-人工智能-PHP中文网

调用火山引擎联网问答api前须正确配置参数，否则返回400或限流；需创建并安全存储accesskey，用hmac-sha256签名且时间戳偏差≤300秒；请求体必含model、messages、enable_web_search；model须选最新版本；请求头需设content-type、x-app-id和authorization签名。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

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

调用火山引擎联网问答会话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}

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

下载

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

{"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-2023090101已下线，调用会直接返回404。

设置关键请求头

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

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

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时间），错一位字符即验签失败。