> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apistable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 认证与密钥

> 网站会话与应用 API 密钥各司其职。

> 当前为 API 预览。生成接口尚未接入供应商，成功认证后仍可能返回 503；不会创建任务或扣积分。

## 使用 Bearer 密钥

外部应用在 Authorization 请求头中携带 API 密钥。浏览器进入控制台使用登录会话。登录 Cookie 不能替代应用的 API 密钥。

```http theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## 账户与密钥边界

每个操作都归属一个账户。密钥只能访问该账户且符合操作 scope 权限的资源，知道其他账户的任务 ID 也不能获取权限。

当前 scope 包含 generations:write 与 usage:read。撤销密钥阻止后续认证调用。真实收费开放前，密钥预算还须计入已消费与未释放冻结；配置了预算字段本身不等于已执行限制。

## 轮换密钥并保留历史

* 创建新密钥、更新服务端并验证，然后撤销旧密钥。
* 撤销不会取消在途任务，也不会返还已完成费用；可通过控制台或其他有效密钥追踪原任务。
* 分享日志或寻求帮助时不要包含完整密钥，请提供 Request ID。

[打开密钥管理](https://apistable.com/console/keys)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.