教程/进阶与开发者

持久 API Key:把 123 GPT 接进自己的程序

桌面端那套开关只对本机的工具有效。如果您要在自己的程序、脚本或线上服务里调用,需要的是持久 API Key —— 它和账号的登录态无关,签发之后一直有效。

5 分钟更新于 2026 年 8 月 1 日面向开发者
本页内容

它和「设备密钥」有什么不同

账号里其实有两种密钥,用途完全不同,别混用:

设备密钥(123- 开头)
桌面端登录时自动签发,绑定这台电脑,会随登录态刷新或失效。 您平时用 Codex 走的就是它,不需要手动管
持久 API Key(123sk- 开头)
手动创建,永不过期,不绑定设备,也不占用电脑名额。 面向「贴进自己的线上服务」这类场景。
计费方式不一样:持久 API Key 恒定按量从余额扣费不走包月套餐。也就是说,即使您开着套餐,用这把 key 发的请求也照样扣余额。 所以请确保余额里有钱。

怎么创建

两个地方都能创建,效果一样:

  1. 桌面端

    侧栏 开发者 页往下找到 API 密钥管理,点新建。 (没有「开发者」入口?先按这里打开开发者模式。)
  2. 网页版

    打开 123gpt.chat/console 登录后,在页面下方的「开发者选项」里创建。 这条路不需要装任何东西。
明文只显示这一次。库里只存哈希,页面关掉就再也取不回来了 —— 创建后请立刻复制并存进您的密码管理器或密钥管理服务。 弄丢了只能删掉重建。

每个账号可创建的活跃 key 有数量上限,页面上会写当前还能建几把。

怎么用

接口与 OpenAI 兼容。把您原来指向 OpenAI 的两个东西换掉即可:

  • Base URL → 换成 https://r1.lic-inc.com/v1
  • API Key → 换成您刚创建的 123sk-…
该地址为大陆加速线路,与 https://123gpt.chat/v1 完全等价, 上传大文件(如带图片的请求)时明显更快,推荐优先使用。

其余请求格式、参数、SDK 用法都不用改。绝大多数支持「自定义 OpenAI 接口地址」的 第三方工具,把这两项填进去就能直接跑。

每把 key 有独立的并发上限,互不影响,也不占用您桌面端的并发。 并发打满时会返回 429,稍等重试即可。

管理与吊销

列表里能看到每把 key 的创建时间和最近使用时间。怀疑泄露、或者某个服务下线了, 直接删掉那把 key —— 删除立即生效,不影响其它 key,也不影响桌面端。

建议一服务一把
出事时能精确吊销,不用全部重来。
别写进代码仓库
放环境变量或密钥管理服务。提交进 git 的密钥等同于公开。
定期清理
不再用的 key 及时删掉。

用量怎么算

用这把 key 产生的消耗会单独归属到它名下,在 用量 页能看到, 和您在桌面端的用量分得清。计费口径与其它请求完全一致,见《看懂用量》