712api

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 / 演示)—— 泄露只需禁一把
  • 怀疑泄露立刻去 控制台 禁用 + 重建

On this page