持久 API Key:将 123 GPT 接入自有程序
桌面端的开关仅对本机工具有效。若需在自有程序或脚本中调用,应使用持久 API Key。该密钥与账号的登录状态无关,签发后持续有效。
与「设备密钥」的区别
账号下共有两类密钥,用途不同,不应混用。
设备密钥(123- 开头)
桌面端登录时自动签发,绑定当前电脑,会随登录状态刷新或失效。 日常使用 Codex 即通过该密钥,无需手动管理。
持久 API Key(123sk- 开头)
手动创建,永不过期,不绑定设备,也不占用电脑名额, 适用于将 123 GPT 接入自有程序或脚本的场景。
两者的计费方式不同:持久 API Key 恒定按量从余额扣费,不使用包月套餐额度。 即使您已开通套餐,使用该密钥发出的请求仍从余额扣除,请确保余额充足。
该接入方式仅供开发与测试阶段使用:每把密钥的并发数量有限, 我方也不对其可用性与稳定性作出承诺。如将其用于生产环境, 相关风险与后果需由您自行承担。
创建方式
以下两处均可创建,效果相同。
桌面端:从更多功能进入
在 侧栏› 更多功能 中点击 长效 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 接口。网页版
打开 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 的密钥等同于公开。
定期清理
及时删除不再使用的密钥。
用量统计
使用该密钥产生的消耗会单独归属于它,可在 用量 页查看, 与桌面端的用量区分显示。计费方式与其他请求完全一致,详见《看懂用量》。
