火山引擎API Key怎么配置到FastGPT？

必须先完成模型提供商注册、渠道绑定、权限开通三步闭环，缺一不可——漏掉火山引擎后台的模型权限开关，哪怕Key填对了也返回403错误。

要把火山引擎的 API Key 正确配置进 FastGPT，必须先完成模型提供商注册、渠道绑定、权限开通三步闭环，缺一不可——漏掉火山引擎后台的模型权限开关，哪怕 Key 填对了也返回 403 错误。

获取火山引擎 API Key

登录火山引擎控制台 → 进入「账号中心」→「API 密钥管理」→ 点击「创建密钥」→ 复制生成的 Access Key ID 和 Secret Access Key。这两串字符必须同时保存，Secret 仅显示一次，

。

在「API 密钥管理」页面右侧，点击「服务授权」→ 勾选「大模型服务（LLM）」→ 提交授权。这一步不操作，后续所有请求都会被拒绝。

在 FastGPT 中添加豆包渠道

进入 FastGPT 后台 → 左侧菜单点「账号」→「模型提供商」→ 右上角「+ 新建」。

填写信息：渠道名随意（如“doubao-volc”），厂商选「豆包」，模型列表填三个映射后的实际模型名（不是正式看到的带日期的原始名）：

举个最直接的例子：
Doubao-1.5-pro-32k 现在对应的是 doubao-1-5-pro-32k-250115
Doubao-1.5-pro-256k 对应的是 doubao-1-5-pro-256k-250115
Doubao-1.5-lite-32k 对应的是 doubao-1-5-lite-32k-250115

。填错一个字母，测试时就会报“model not found”。

开通火山引擎端模型调用权限

回到火山引擎控制台 →「账号中心」→「大模型服务」→「REST API」→ 找到模型列表页。

逐个点击你填入映射表里的三个 Value 模型名（如 doubao-1-5-pro-32k-250115），进入详情页 → 找到「调用权限」开关 → 开启 → 保存。

每个模型都要单独点开、单独开启，不能批量操作。没开权限的模型在 FastGPT 测试时会直接返回 403 Forbidden，而不是密钥错误。

验证配置是否生效

在 FastGPT 的「模型提供商」列表里，找到刚添加的豆包渠道 → 点击右侧「测试」按钮。

输入任意简短提示（如“你好”）→ 点击发送 → 成功返回响应文本且状态码为 200，即配置完成。

若失败，优先检查火山引擎后台的模型权限开关是否全部打开，其次核对映射表 Value 是否与 REST API 页面显示的模型 ID 完全一致（包括大小写和连字符）。