跳到正文

API 密钥 ​

API 密钥用于调用 Gateway,同一账号下的密钥共用账号余额。国内站密钥用于 https://gw.zeroseal.cn;海外站的账号、密钥和余额独立,不能混用。

创建与保存 ​

  1. 打开 API 密钥,点击「新建密钥」。
  2. 填写便于区分用途的名称,点击「创建」。
  3. 复制并保存完整密钥,点击「我已保存」。

完整密钥只显示一次,关闭后只能查看名称、前缀和创建时间。遗失后需创建新密钥。每个账号最多 30 把,达到上限时先删除不用的密钥。

用于请求 ​

在请求头中传入完整密钥:

http
Authorization: Bearer <API_KEY>

Bearer 后有一个空格。密钥名称、列表中的前缀和控制台登录凭据都不能代替完整 API 密钥。

按 首次调用 设置 ZEROSEAL_API_KEY,由服务端程序读取。不要将密钥放进浏览器前端、仓库或日志。

替换与删除 ​

更换密钥时,按以下顺序操作:

  1. 创建新密钥。
  2. 更新应用中的密钥配置,重启或重新加载配置。
  3. 确认应用使用新密钥调用成功。
  4. 回到 API 密钥,找到旧密钥,点击「删除」并确认。

删除无法撤销,旧密钥的后续请求会返回 401。如果密钥已泄露,先删除,再为应用配置新密钥。

请求失败 ​

返回内容检查项
401,缺少 Bearer 凭据请求是否带 Authorization,值是否以 Bearer 开头。
401,凭据无效密钥是否完整、已被删除,或来自海外站。
402,余额不足账号余额不足以预扣本次请求,充值或减少输出预算。

公开模型目录无需密钥,读取成功不代表密钥有效。完整调用示例见 首次调用。