ApiKey 管理
创建令牌、选对分组、排查鉴权报错。
712api 控制台里的「令牌」就是你调 API 的 Key。一把令牌挂一个分组,分组决定它能调什么模型——每个模型对应哪个分组去 模型广场 左侧「可用令牌分组」查。
入口:控制台 → 令牌管理(创建 / 复制 / 编辑 / 禁用 / 删除)
新建一把可用的 Key
打开令牌管理 → 点右上角「添加令牌」

填名称(仅自己区分,例:codex-cli-mac)
选分组——这是最关键的一步。去 模型广场 左侧「可用令牌分组」看你要用的模型在哪个分组里,在创建对话框里选中该分组。

留默认 default 调不通任何模型 —— 这是最常见的「为什么我的 Key 不行」原因。
其余字段(无限额度 / 模型限制 / IP 白名单 / 过期时间)按需调,默认值适合绝大多数场景。详见下方「字段速查」。
保存 → 复制
粘到客户端配置即可。new-api 已默认在令牌前加好 sk- 前缀,无需手动添加。

字段速查
| 字段 | 默认 | 怎么用 |
|---|---|---|
| 分组 | default | 必改:按模型选对分组,例如要用 GPT-5 系列就选 codex,要用 Claude Opus 系列就选 kiro,详见 模型广场 |
| 无限额度 | 开 | 开 = 用账户余额。关 = 给这把 Key 单独划一个额度池,用完即停(不影响账户余额) |
| 模型限制 | 不限 | 自用留空。给别人时可只放行 gpt-5.4-mini 等便宜模型 |
| 过期时间 | 永不 | 临时分发可设几天 |
| IP 白名单 | 不限 | 一行一个 IP 或 CIDR;生产环境建议加 |
| 跨分组重试 | 关 | 仅 auto 分组用,普通用户无需开 |
同一账号可建多把 Key,按用途分组(不同模型可能需要不同分组),账户余额所有 Key 共享。
常见报错
安全
- 不要把令牌提交进 git,放
.env并加.gitignore - 按用途分 Key(个人机 / CI / 演示)—— 泄露只需禁一把
- 怀疑泄露立刻去 控制台 禁用 + 重建