创建和管理 API Key
API Key 是程序和客户端调用网关的凭证。控制台页面叫「API 密钥」,地址是 https://openbridger.com/keys。
开始之前
- 已经登录控制台。
- 知道这把密钥要给哪一个工具。一个工具一把密钥,停用和查账都更清楚。
创建
打开 API 密钥
进入 https://openbridger.com/keys,新建密钥。
填写名称
名称最多 50 个字符,用工具或项目名,例如 cursor、claude-code、server-prod。
按需限制范围
页面可以设置分组、模型范围、密钥额度、过期时间和 IP 白名单。不确定就先保持默认,用短请求验证,再收紧。
复制完整密钥
控制台展示和复制的值带 sk- 前缀。请求时写成 Authorization: Bearer sk-...。网关会去掉这个前缀再查密钥,所以不要自己再加一次 sk-。
截图待补
新建密钥抽屉:名称、分组、额度、过期时间、模型限制、IP 白名单。由运营用当前界面替换本段。
创建数量有上限,达到上限时接口会拒绝再创建。具体上限由运营配置,页面报错里的数字就是当前值。
登录状态下可以再次查看某把密钥的完整值。这不表示它可以出现在仓库、前端包、截图或工单里。
页面上这几项实际会生效
| 设置 | 行为 |
|---|---|
| 额度不限 / 剩余额度 | 关闭「不限」后,这把密钥有自己的剩余额度。用尽后调用返回 401「无效的令牌」,即使钱包里还有余额。 |
| 过期时间 | 到期后同样是 401「无效的令牌」。-1 表示不过期。 |
| 模型限制 | 打开后,密钥只能调用列出的模型 ID。 |
| 分组 | 留空则用账户分组。填了分组时,该分组必须在你的可用分组里,并且没有被弃用,否则 403。 |
分组选 auto |
按你排列的分组顺序尝试。可以打开「跨分组重试」:当前分组的线路失败时再试下一组。 |
| IP 白名单 | 留空不限制。填写后,来源 IP 不在列表里会 403,code 为 access_denied。 |
| 禁用 | 禁用后的密钥不能调用。只读的用量查询接口同样拒绝已禁用的密钥。 |
普通用户不能在密钥后面加 -渠道ID 来指定上游渠道,那样会 403,文案是「普通用户不支持指定渠道」。
建议
按用途拆开
Cursor、Claude Code、线上服务各用一把。泄露或离职时只停一把。
服务端持有
不要把密钥放进浏览器、App 安装包或公开仓库。网页产品由你的服务器转发出去。
轮换
泄露、人员变动或项目结束时,禁用或删除旧密钥,再发一把新的。支持人员不会向你要完整密钥或密码。
验证
curl "https://openbridger.com/v1/models" \
-H "Authorization: Bearer sk-你的密钥"
返回模型列表,说明这把密钥和网络是通的。列表是这把密钥当前分组能看到的模型,不是上游的全部目录。