绑定API Key时必须填写模型ID(如mlu-123456789),而非展示名;需在模型详情页顶部右侧复制该ID,再于API Key编辑页手动输入或下拉选择;验证时通过在线调试返回200且含output字段即成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在火山引擎控制台为大模型服务绑定API Key时,必须准确填写模型名称才能完成授权,填错会导致调用失败且无明确报错提示。
确认模型名称的来源
登录火山引擎控制台 → 进入「机器学习平台(MLaaS)」→ 左侧导航栏点击「模型服务」→ 找到目标已部署模型 → 点击模型名称进入详情页。
在模型详情页顶部标题栏右侧,会显示形如 【mlu-123456789】 的唯一模型ID,这个ID就是绑定API Key时必须填写的“模型名称”。
注意:不是模型展示名(如“Qwen2-7B-Instruct”),也不是服务名或部署实例名,必须复制该ID字符串。
在API Key绑定页填写模型名称
返回「访问密钥」页面 → 找到目标API Key → 点击「编辑权限」→ 在「模型服务权限」区域点击「添加模型」。
方法一:手动输入
直接粘贴上一步复制的模型ID(例如 mlu-123456789)到「模型名称」输入框中 → 点击「确定」。
方法二:下拉选择(仅限已部署且已授权的模型)
点击「模型名称」右侧下拉箭头 → 从列表中选择对应模型 → 系统自动填入其ID → 点击「确定」。
【若下拉列表为空,请先确保该API Key所属用户具备该模型的「查看」或「调用」权限】
验证绑定是否生效
第一步:在模型详情页右上角点击「在线调试」→ 展开「请求参数」区域 → 查看「Authorization」字段是否已自动填充当前API Key。
第二步:在「Body」中输入标准JSON请求(如{"prompt":"你好"})→ 点击「发送请求」。
第三步:观察响应状态码。返回200且含"output"字段即表示模型名称填写正确、绑定成功;若返回403或"model not found",说明模型名称填错或权限未同步,需重新检查ID并等待1~2分钟权限缓存更新。


















