postman测试火山引擎api需严格配置鉴权头、请求方式和url路径，否则返回401或400错误；必须设置authorization（含动态签名）和content-type，且签名须通过pre-request script自动生成，model值须与控制台完全一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用Postman测试火山引擎API，必须先配置鉴权头、选对请求方式、填准URL路径，否则会直接返回401或400错误。你不能只填个URL就点Send——火山引擎所有大模型API都强制校验Authorization和Content-Type，缺一不可。
准备环境与获取密钥
登录火山引擎控制台 → 进入「大模型」→ 点击「火山方舟」→ 左侧菜单选「API管理」→ 创建新API → 复制生成的【Access Key ID】和【Secret Access Key】。这两个值不能截图后直接粘贴进Postman，因为Secret Key需要参与签名计算，必须配合Postman内置脚本使用。
在Postman中点击右上角「Settings」→「Secrets」→ 新建一条Secret，名称设为ark_secret，值填入刚复制的Secret Access Key。这一步漏掉，后续所有签名都会失败。
设置请求基础参数
新建一个Request → 请求方法选POST → URL填：https://ark.cn-beijing.volces.com/api/v3/chat/completions（注意：地域节点cn-beijing不可替换，其他地域如cn-shanghai暂不支持该接口）。
Headers里必须添加两行：
Key: Content-Type → Value: application/json
Key: Authorization → Value: 【Bearer 后面必须接一个空格，再拼接动态生成的签名串】
签名串不能手写，必须用Pre-request Script自动生成——否则时间戳过期、签名错一位，全盘失败。
编写Pre-request Script生成签名
点击「Pre-request Script」标签页，粘贴以下代码：
const crypto = require('crypto');<br>const timestamp = Math.floor(Date.now() / 1000);<br>const accessKeyId = pm.environment.get("access_key_id") || "your_access_key_id";<br>const secretKey = pm.secrets.get("ark_secret");<br>const method = "POST";<br>const path = "/api/v3/chat/completions";<br>const body = JSON.stringify({<br> model: "doubao-1.5-pro-32k-250115",<br> messages: [{role:"user",content:"test"}]<br>});<br>const contentHash = crypto.createHash('sha256').update(body).digest('hex');<br>const stringToSign = `${method}\n${path}\n${timestamp}\n${contentHash}`;<br>const signature = crypto.createHmac('sha256', secretKey).update(stringToSign).digest('base64');<br>pm.request.headers.upsert({key:"Authorization", value:`Bearer ${accessKeyId}:${timestamp}:${signature}`});<br>pm.environment.set("request_body", body);
这段脚本会自动算出符合火山引擎签名规范的Authorization头。注意：body内容必须和下方Body里的JSON完全一致，否则contentHash对不上，签名无效。
填写请求体Body
切换到「Body」→ 选「raw」→ 右侧下拉选「JSON」→ 粘贴如下内容：
{<br> "model": "doubao-1.5-pro-32k-250115",<br> "messages": [<br> { "role": "system", "content": "You are a helpful assistant." },<br> { "role": "user", "content": "Hello!" }<br> ]<br>}
model字段值必须从火山方舟控制台「模型列表」里复制真实可用的型号，写错大小写或加空格都会触发404。比如"doubao-1.5-pro-32k-250115"不能写成"doubao-1.5-pro-32k-250115 "（末尾多一个空格）。
发送并验证响应
点击Send按钮 → 查看Response选项卡 → 状态码应为200 → 响应体中出现"choices"数组且含"message.content"字段 → 表示调用成功。
若返回{"error":{"code":"Unauthorized","message":"Invalid signature"}}，说明Pre-request Script里的secret值为空或拼写错误；若返回{"error":{"code":"ModelNotFound"}}，检查model字段是否抄错。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
