Postman可30秒内完成带鉴权的火山引擎大模型Chat API调用并实时查看流式响应；需配置ARK_API_KEY和REGION全局变量，设置Bearer鉴权、正确model ID及启用Stream response data开关。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要用Postman快速验证火山引擎大模型接口是否可用、参数是否正确、流式响应能否正常接收，而不是反复改代码重跑——Postman能让你在30秒内完成一次带鉴权的Chat API调用，并实时看到data: chunk或完整JSON返回。
配置API Key环境变量
打开Postman → 点击右上角「Settings」→ 选择「Variables」标签页 → 在「Globals」区域新增两行：
变量名填 ARK_API_KEY，当前值粘贴你从火山引擎控制台复制的AccessKey ID（形如 ak-xxxxxxxx）；
变量名填 REGION，当前值填 cn-beijing（目前方舟平台仅开放北京Region）。
这一步必须做，否则后续所有请求都会因Header缺失或拼写错误返回401。注意：Secret Key不用于Postman直连，只用AccessKey ID + Bearer鉴权。
新建请求并设置基础参数
点击左上角「New」→「Request」→ 命名为“Doubao Chat Test” → 保存到任意Collection中。
在地址栏输入URL：
https://ark.{{REGION}}.volces.com/api/v3/chat/completions
请求方法选 POST；
Headers里添加两行：
Content-Type → application/json
Authorization → Bearer {{ARK_API_KEY}}
URL中的{{REGION}}和Header里的{{ARK_API_KEY}}会自动替换为全局变量值。如果没生效，检查右上角环境切换器是否关闭——它必须处于启用状态且未选中任何环境（此时默认读Globals）。
填写请求体（Body）
切换到Body选项卡 → 选「raw」→ 右侧下拉菜单选「JSON」。
粘贴以下内容（请严格使用双引号，不要用中文标点）：
{
"model": "doubao-seed-2-1-pro-260628",
"messages": [
{"role": "user", "content": "你好"}
],
"max_tokens": 512,
"temperature": 0.3
}
model字段必须填你在ARK控制台「推理接入点」页面看到的真实Model ID，不是“doubao”或“豆包”。填错会返回404或400，且错误提示不明确。
启用流式响应监听
点击右上角「Settings」→ 找到「Stream response data」开关 → 打开它。
发送请求后，响应区将逐行显示以 data: 开头的内容，每行一个JSON chunk，最后一行为 data: [done]。若只看到空白或报错，请确认：① URL路径是否含 /api/v3/；② model ID是否在当前项目空间已部署；③ API Key是否已授权该模型调用权限。
如果不开启此开关，Postman会等待整个响应结束才渲染，无法验证流式能力——而语音交互、长文本生成等场景强依赖流式。
一键复用：保存为Collection模板
第一步：点击右侧「Save」→ 选择已有Collection或新建一个，命名为“VolcEngine LLM Tests”；
第二步：在Collection右侧三个点 → 「Edit」→ 切换到「Variables」页 → 添加同名变量 ARK_API_KEY 和 REGION，并设好CURRENT VALUE；
第三步：回到请求页，点击「Params」→ 在Query Params中添加一行：
key = model_id，value = {{model_id}}；
然后在Body JSON中把model字段改为 "model": "{{model_id}}"；
第四步：在Collection的「Pre-request Script」中加入：
pm.variables.set("model_id", "doubao-seed-2-1-pro-260628");
这样每次运行整个Collection时，model_id会自动注入，无需手动改Body。下次测试其他模型，只需改这一行脚本即可。
