火山引擎不支持重新启用已停用的API Key，必须新建密钥并同步替换所有使用位置：先确认密钥状态为“已停用”，再创建新Key、复制密钥值和对应endpoint，最后更新opencode.json及各客户端配置中的apiKey与baseURL。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在火山引擎方舟控制台里误操作停用了正在用的 API Key，现在调用模型直接报 401 认证失败，但密钥列表里只显示“已停用”，找不到“启用”按钮或恢复入口——这是因为火山引擎不支持对已停用的 API Key 执行重新启用操作，必须新建一个并同步替换所有使用位置。
确认 API Key 状态并理解不可逆性
登录火山引擎控制台 → 进入「API 访问密钥」页面（头像下拉菜单直达）→ 找到目标密钥，观察状态列。若显示【已停用】，说明该密钥的 credential 已被服务端强制注销，所有 bearer token 请求将立即拒绝，且【无法通过任何界面或 API 恢复】。
这一步不能跳过：停用是单向操作，没有回收站，也没有“启用”按钮——火山引擎设计上只允许创建和停用，不提供重活机制。
新建可用 API Key 并完成关键信息提取
点击页面右上角「创建 API Key」按钮。
在弹出框中填写名称（建议带日期和用途，如“deepseek-r1-20261021-prod”），点击「确定」。
密钥生成后，立刻点击右侧「眼睛图标」查看完整密钥值，并【务必一次性复制完整】——页面关闭后密钥明文永不展示，再次进入只能看到掩码（如 “ak-****1234”）。
同时，在同一页面左上角，找到并复制当前区域的 endpoint 域名（形如 maas-api.ml-platform-cn-beijing.volces.com），这是后续配置 baseURL 的核心部分，不是通用域名。
替换所有依赖该密钥的配置项
第一步：打开本地 opencode.json 文件，定位到 "auth" 区块，将 "apiKey" 字段值替换为新复制的密钥字符串。
第二步：检查 "baseURL" 是否仍指向旧接入点地址。如果之前填的是带 /v1 后缀的完整 URL（如 https://ep-xxx.volces.com/v1），请删掉后缀，只保留协议+域名（https://ep-xxx.volces.com）——OpenCode 会自动拼接路径，填错会导致 404。
第三步：若使用 ChatBox、OfficeAI 或自研客户端，进入其「大模型设置」→「ApiKey 接入」页，粘贴新密钥、更新模型 ID（如有变更）、确认 baseURL 与新密钥所属区域一致（例如北京区密钥不能配上海 endpoint）。
第四步：保存全部配置文件，重启对应应用进程。此时旧密钥彻底失效，新密钥开始生效。
