身份验证与 API 密钥

在 Authorization 请求头中发送密钥

Authorization: Bearer YOUR_API_KEY

API 只从这个请求头读取密钥。

• 绝不要把密钥放在 URL 中（?api_key=…）。URL 会留在日志、浏览器历史记录和分享的链接里。API 会拒绝这类请求，返回 400 api_key_in_query。请把这个密钥视为已泄露：吊销它，再创建一个新密钥。
• 请求地址必须是 https://gloriads.com/api/v1：客户端跟随重定向跳到其他地址时，会在途中丢失密钥。
• 从电子表格、脚本或服务器调用 API，不要在网页代码中调用：任何访问该网页的人都能读到密钥。

密钥能做什么

• 在所有端点上读取您的账户数据。
• 不能更改任何内容。API 是只读的。
• 共享账户的限额：您所有的密钥和已连接的 AI 助手合并计算，所以多一个密钥并不会多出请求次数。请参阅限制与错误。

创建密钥

设置 → API → 创建密钥。

• 名称最多 40 个字符。用工具名称来命名，以后就知道该吊销哪个密钥。
• 密钥只显示一次。我们只保存它的指纹，因此任何人都无法再次查看，我们自己也不行。请把它保存在密码管理器或工具的保密设置中。
• 最多可同时拥有 10 个密钥。
• 公开演示账户无法创建密钥。

密钥列表

每个密钥都会显示名称、开头几个字符（key_live_ab12…）、创建时间和最后使用时间。

“最后使用时间”最多每小时更新一次，所以几分钟前刚用过的密钥，显示的仍可能是更早的时间。

吊销密钥

打开密钥的 ⋯ 菜单，选择吊销。

吊销立即生效：下一次使用该密钥的请求会收到 401 unauthorized，与从未存在过的密钥返回相同的结果。吊销的密钥无法恢复，请创建新密钥。

无需密钥连接的 AI 助手

claude.ai 和 ChatGPT 不使用密钥：您在助手中登录 Gloriads，然后点击允许。助手随后会获得自己的访问权限，只能读取。连接方法：请参阅连接 AI 助手。

• 设置 → API → 已连接的应用会列出每个助手、请求访问的地址、连接时间以及最后一次读取账户的时间（最多每小时更新一次）。
• 名称旁显示未验证，表示该应用自行注册，但没有证明其地址。只有当它是您亲自连接的，才保留它。
• 要停止某个助手，打开它的 ⋯ 菜单，选择断开连接。立即生效。要再次使用，请从助手中重新连接。

请求被拒绝时

其他所有错误代码请参阅限制与错误。

公开演示密钥

API 参考文档的 Try it 按钮预先填入了一个公开密钥。它只能读取演示账户，限额为每分钟 10 次请求，由所有访客共享。它无法读取您的账户：读取您的账户请使用您自己的密钥。