OpenCode 提示 API key 已过期？重申一把新 key 即可解决（控制台操作图解）

来源：网站领地　浏览：0次　时间：2026-10-20

简介：使用 opencode 免费模型时，某天启动可能突然弹出 This API key has expired 的提示。报错信息包含三层意思：当前 key 已失效；需要到 OpenCode Console 里创建一把新 key，并替换客户端或密钥存储中的旧值；再次登录并不会让原 key 续期。官方已明确说明重新登录无法恢复，因此别在旧 key 上浪费时间，重新申请并替换是唯一可行的…

用 opencode 的免费模型时，某天一打开就蹦出这么一段提示：

This API key has expired. Create a new API key in OpenCode Console
and replace it in your client or secret store. Signing in again will not renew this key.

一共三句话，咱们一句句拆开看：

你的这把 key 已经到期失效；

到 OpenCode Console 里重新生成一把，替换掉客户端中存放的那把旧的；

就算重新登录，也不会让这把 key 恢复有效。

前两句照着字面执行就行，第三句是官方特意用来堵住"退出再登录一次"这个下意识想法的——错误提示里直接写明了：Signing in again will not renew this key。别在旧 key 上浪费时间，重新弄一把新的才是唯一出路。

先搞清楚：这是 key 过期，不是被限流

不少人一见到 401 就按"限流"处理，傻等半天也没好转。请认准错误码：

报错	含义	应对方式
`401` + `api_key_expired` / This API key has expired	key 到期失效	换新 key，干等无用
`401` + Invalid credential	key 复制出错/无效	确认粘贴内容是否完整
`429` + Rate limit exceeded	触发限流	换一个模型或稍等片刻

接下来进入正题：两步搞定 key 更换。

第一步：登录官方控制台，重新申请一把 key

打开 OpenCode 控制台的登录页（opencode.ai/auth），可以用谷歌 / GitHub / 邮箱三种途径登录，如果还没账号，就点页面底部的「创建账户」：

图 1：控制台登录页，谷歌、GitHub、邮箱三种登录方式随意挑

登录成功后，进入 Settings → Service accounts，点击 Add API Key，起个名字、选好权限，Expiry date 那里个人账户可以直接勾选 never（永久有效，这次弄完以后就不用再折腾了）。

新 key 以 oc_sk_ 开头，样子类似 oc_sk_xxxxxxxxxx——先复制保存好，页面先别关。

第二步：回到 opencode，把新 key 填入「Use API key」

操作路径：设置 → 提供商 → OpenCode，此时会弹出「连接 OpenCode Console」对话框：

图 2：弹窗里别去点 Continue in the browser，点红箭头指向的 Use API key，把刚才复制的 oc_sk_ 新 key 粘贴进去

这一步有个容易误点的按钮，注意区分：

Continue in the browser = 通过浏览器重新走一遍登录授权——对已过期的 key 毫无作用（正是报错里说的 "Signing in again will not renew this key"）；

Use API key = 手动填入 key —— 选这个，把第一步复制下来的 oc_sk_ 新 key 粘贴进去。

粘贴并保存，provider 重连成功后，问题就解决了。

顺手处理一下：如果你的 opencode.json / opencode.jsonc 里 baseURL 还是旧的 /zen/v1，借这次机会改成 https://opencode.ai/inference/v1。推理端点已经迁移到新结构（模型列表在 /inference/v1/models，chat 接口为 /inference/openai/v1/chat/completions），旧地址目前只是作为别名还在用，官方文档已经全面切换到新地址。

第三步：验证一下

切到 OpenCode 的模型，随便发一句 say hello：

能正常回复 → 新 key 已经生效，搞定收工；

依然报 401 → 说明 key 没粘贴对（看看首尾有没有丢字符），或者你改的不是实际在用的那份配置。

最容易踩的三个坑

按钮点错：在弹窗里选了 Continue in the browser 重新登录，以为再登一次就能救回来——救不了，报错原文已经写死了。

只改 key 不重启：如果是手动编辑配置文件，改完后必须重启 opencode 或者重连 provider 才会生效。

把 key 过期误认为限流：api_key_expired 表示到期失效，429 才是限流，前者无论等多久都不会自愈。

总结一句话

OpenCode 提示 This API key has expired，就去控制台重新生成一把 oc_sk_ key，然后回到设置 → 提供商 → OpenCode → Use API key 粘贴进去，发一句 say hello 测试。重新登录没法续期，换新 key 才是唯一的解决办法。

标签： 401报错 API密钥过期 OpenCode Console oc_sk_ 重新申请key