火山引擎API Key绑定模型后怎么用Postman测试？-人工智能-PHP中文网

postman调用火山引擎模型接口需手动构造hmac-sha256签名：先配置环境变量（access_key、secret_key、region、host），再按规范拼接字符串并用secret access key生成signature，最后设置authorization、x-date、host等headers，确保时间戳、model值与控制台一致。

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

火山引擎api key绑定模型后怎么用postman测试？

你需要在Postman里调用火山引擎已绑定API Key的模型接口，但直接填Key发请求总返回401或403，根本原因是鉴权头没对、时间戳过期或Body结构不匹配。

准备火山引擎API Key和模型信息

登录火山引擎控制台 → 进入「大模型服务」→「火山方舟」→「API管理」→ 创建新API Key。记下Access Key ID和Secret Access Key，【Secret Access Key只显示一次，关闭页面后无法再次查看】。

在「模型管理」中确认你已开通并授权使用的模型ID，例如doubao-1.5-pro-32k-250115或deepseek-r1。不要用控制台里显示的“服务名称”，必须用API文档明确写出的model字段值。

配置Postman环境变量

点击右上角「Environments」→「Create Environment」→ 命名为volc-api → 添加以下变量：

access_key：填你复制的Access Key ID
secret_key：填你复制的Secret Access Key
region：填cn-beijing（北京）或cn-north-1（华北），必须与你在控制台创建API Key时选择的地域一致
host：ark.cn-beijing.volces.com（若region为cn-beijing）或ark.cn-north-1.volces.com（若region为cn-north-1）

保存后，在右上角环境选择器中切换到volc-api。这一步漏掉会导致后续所有签名计算失败。

构造签名并设置Headers

Postman本身不自动签V4，你必须手动计算Authorization头。打开任意在线HMAC-SHA256工具（如https://www.freeformatter.com/hmac-generator.html），按以下顺序拼接：

① 生成当前UTC时间戳：格式为YYYYMMDDTHHMMSSZ，例如20260805T174600Z
② 提取日期部分：20260805
③ 拼接字符串：POST\n/api/v3/chat/completions\n\nhost:{{host}}\nx-date:{{时间戳}}\ncontent-type:application/json\n\nhost;x-date;content-type\n{你的Body的SHA256哈希值（空Body则用e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855）}

用secret_key作为密钥，对上一步拼接的字符串做HMAC-SHA256 → 得到二进制结果 → Base64编码 → 得到Signature。

火山引擎

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

下载

最终Authorization头格式为：
Authorization: HMAC-SHA256 Credential={{access_key}}/{{日期}}/{{region}}/ark/request, SignedHeaders=host;x-date;content-type, Signature={{Signature}}

填写请求URL和Body

请求方式选POST，URL填：https://{{host}}/api/v3/chat/completions

Headers里添加三行：

Content-Type：application/json
X-Date：{{时间戳}}（必须与签名中完全一致）
Host：{{host}}

Body选raw → JSON，填入：

{ "model":"doubao-1.5-pro-32k-250115", "messages": [ { "role":"user", "content":"你好" } ], "stream":false }

发送并验证响应

点击Send。成功响应状态码为200，body中包含choices[0].message.content字段。

若返回{"error":{"code":"Unauthorized","message":"Invalid signature"}}，检查X-Date是否与时区偏差超过15分钟；若返回{"error":{"code":"ModelNotAuthorized","message":"Model not found or not authorized"}}，确认model字段值是否与火山方舟控制台「模型详情页」URL路径中的标识完全一致。