教程/进阶与开发者

持久 API Key:将 123 GPT 接入自有程序

桌面端的开关仅对本机工具有效。若需在自有程序或脚本中调用,应使用持久 API Key。该密钥与账号的登录状态无关,签发后持续有效。

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

与「设备密钥」的区别

账号下共有两类密钥,用途不同,不应混用。

设备密钥(123- 开头)
桌面端登录时自动签发,绑定当前电脑,会随登录状态刷新或失效。 日常使用 Codex 即通过该密钥,无需手动管理。
持久 API Key(123sk- 开头)
手动创建,永不过期,不绑定设备,也不占用电脑名额, 适用于将 123 GPT 接入自有程序或脚本的场景。
两者的计费方式不同:持久 API Key 恒定按量从余额扣费,不使用包月套餐额度。 即使您已开通套餐,使用该密钥发出的请求仍从余额扣除,请确保余额充足。
该接入方式仅供开发与测试阶段使用:每把密钥的并发数量有限, 我方也不对其可用性与稳定性作出承诺。如将其用于生产环境, 相关风险与后果需由您自行承担。

创建方式

以下两处均可创建,效果相同。

  1. 桌面端:从更多功能进入

    侧栏›  更多功能 中点击 长效 API Key。 页面上半部分为两种风格的接入地址,下半部分为密钥的创建与管理。
    更多功能
    常用功能
    使用帮助
    查看 123 GPT 使用指南、功能教程与常见问题。
    技能中心
    浏览并安装 SkillHub 平台提供的 Codex Skill,用于扩展 Codex 的能力。
    修复 ChatGPT 界面语言
    ChatGPT 应用的界面无法切换为中文时,执行一次修复。该修复仅对本次运行有效,可重复执行。
    1 Switch
    添加并切换 123 GPT 以外的供应商,例如其他中转站或公司自建的服务,无需另装 CC Switch。此类请求不经过 123 GPT。
    其他功能
    聊天记录管理
    导出、导入本机 Codex 聊天记录,并可删除不再需要的会话以释放磁盘空间。
    上下文上限
    设置 Codex 单次请求可携带的最大上下文长度;恢复默认后沿用 Codex 自带的上限。
    适配 Claude Code
    将 Claude Code 接入 123 GPT,无需手动修改 ~/.claude 配置文件;Claude 桌面端的 Code 标签页一并生效。
    适配 opencode
    将 opencode 接入 123 GPT,无需手动修改 ~/.config/opencode/opencode.json 配置文件。
    长效 API Key
    生成不随登录状态失效的 API Key,供服务器或其他程序调用 123 GPT 接口。
  2. 网页版

    打开 123gpt.chat/console 并登录后, 在页面下方的「开发者选项」中创建。该方式无需安装任何程序。
密钥明文仅显示一次。服务端只保存哈希值,页面关闭后无法再次取得。 创建后请立即复制并保存至密码管理器或密钥管理服务。 如已遗失,只能删除后重新创建。

每个账号可创建的活跃密钥数量有上限,页面上会显示剩余可创建的数量。

在团队空间中,该项目仅团队所有者可见。若您以成员身份加入团队, 切换到该团队空间后「更多功能」中不会显示此项 —— 团队的密钥由所有者统一管理。 切回个人空间即可正常使用。

使用方式

接口与 OpenAI 兼容,只需替换原先指向 OpenAI 的两项配置:

  • Base URL:改为 https://r1.lic-inc.com/v1
  • API Key:改为新创建的 123sk-…
该地址为大陆加速线路,与 https://123gpt.chat/v1 完全等价, 在上传较大文件(例如包含图片的请求)时速度明显更快,建议优先使用。

其余的请求格式、参数与 SDK 用法均无需改动。 多数支持自定义 OpenAI 接口地址的第三方工具,填入这两项后即可直接使用。

每个密钥最多 8 个并发请求,相互之间不受影响, 也不占用桌面端的并发。并发达到上限时会返回 429,稍候重试即可。

管理与吊销

列表中可查看每个密钥的创建时间与最近使用时间。 如怀疑密钥泄露,或对应的服务已下线,直接删除该密钥即可。 删除立即生效,不影响其他密钥,也不影响桌面端。

按服务分别创建
出现问题时可精确吊销单个密钥,无需全部重建。
不要写入代码仓库
请存放于环境变量或密钥管理服务中。提交至 git 的密钥等同于公开。
定期清理
及时删除不再使用的密钥。

用量统计

使用该密钥产生的消耗会单独归属于它,可在 用量 页查看, 与桌面端的用量区分显示。计费方式与其他请求完全一致,详见《看懂用量》