Skip to Content
快速开始密钥与鉴权

密钥与鉴权

本页面向:企业成员与企业管理员。 创建和管理企业共享密钥的完整操作在共享 API 密钥。

两种密钥,扣的钱不一样

这是最需要先弄清楚的一件事:

个人密钥企业共享密钥
在哪管理控制台的「API 密钥」页(/keys)企业控制台 → 共享 API 密钥(/org/tokens)
归属你个人整个企业,不归到某个成员名下
扣谁的钱你个人账户的余额企业的共享余额
企业余额不足时不适用不会回落到你的个人钱包
受什么约束你个人的额度与订阅密钥自身的额度
谁能创建你自己企业管理员(成员通常看不到这一页)

共享密钥不走个人钱包回落。 它用的是企业余额;企业余额不足时请求会被拒绝,而不是转去扣使用者的个人余额。所以给同事发共享密钥,等于把企业的余额交给对方使用——发放前请确认密钥额度。

个人成员的实际消费走哪一侧,由企业的计费策略决定:企业为成员开启企业计费时默认扣企业余额,并且只有在企业允许「个人钱包回落」时,企业余额不足才会转扣成员自己的余额。这些开关在企业设置里。

鉴权方式

按 OpenAI 兼容约定,在请求头里带上密钥:

Authorization: Bearer sk-...

Base URL 为:

用途地址
OpenAI 兼容接口https://alltokens.si/v1
网关健康检查(不需要密钥)https://alltokens.si/api/status

密钥状态

控制台里每个密钥会显示状态,含义如下:

状态含义怎么处理
启用正常可用—
停用被手动关闭,请求会被拒需要时重新启用
过期超过设定有效期新建一个
用尽已达到该密钥的额度上限追加额度或新建

安全建议

  • 密钥等同于余额。不要写进代码仓库、不要贴进聊天群、不要放进前端页面或浏览器里。
  • 用环境变量或密钥管理服务注入,不要硬编码。
  • 不同用途用不同密钥,这样一个泄露时只影响一处,也便于在请求明细里分辨来源。
  • 怀疑泄露时立即停用或删除该密钥,再新建一个。
  • 密钥明文通常只在创建时完整显示一次,请当场保存好。

相关页面