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

# 什么是 Admin Key

> 用于让脚本以编程方式管理你自己账号的长期凭据，不是调用模型用的密钥。

Admin Key（管理 Key）让脚本以编程方式管理**你自己的账号**：查余额、导出调用日志、统计用量、轮换 API 密钥。

> [!WARNING]
>
> **Admin Key 不能用来调用模型。** 它和 API 密钥是两种完全不同的凭据，用错了会直接报错。
>
> | | API 密钥 | Admin Key |
> | - | - | - |
> | 前缀 | `sk-ep-` | `sk-admin-` |
> | 用途 | 调用模型 | 管理账号 |
> | 请求地址 | `/v1/...` | `/api/...` |
> | 会消耗额度 | 是 | 否 |

## 创建

**1. 进入管理 Key 页面**

登录 [控制台](https://platform.ephone.ai)，在侧边栏选择 **构建与使用 → 管理 Key**。

**2. 填写名称并选择作用域**

起一个能认出用途的名字，例如「对账脚本」。然后**只勾选这个脚本真正需要的作用域**，默认勾选的三项都是只读的。作用域清单见[作用域](https://docs.rixapi.com/docs/cn/admin-key/scopes.md)。

**3. 选择有效期**

可选 7 天、30 天、90 天、365 天、自定义天数或永不过期。

**4. 立即保存明文**

创建成功后完整内容只显示这一次。关闭对话框之后无法再次查看，系统只保存它的哈希值。

## 认证方式

把 Admin Key 放进 `Authorization` 请求头：

```bash theme={null}
curl https://api.ephone.ai/api/user/self \
  -H "Authorization: Bearer sk-admin-你的Key"
```

响应是标准的 JSON 信封：

```json theme={null}
{
  "success": true,
  "message": "",
  "data": { "username": "...", "balance": "12.3456", "...": "..." }
}
```

`success` 为 `false` 时，`message` 里是可读的失败原因，部分错误还带 `code` 字段。

## 能力边界

Admin Key 能做什么完全由你勾选的作用域决定。除此之外还有三条**无论勾选什么都不可逾越**的边界：

> [card] 碰不到管理后台
>
> 管理端、代理商端、供应商端的全部接口一律拒绝，与账号角色无关。管理员账号的 Admin Key 同样只能做用户端的事。

> [card] 改不了账号安全
>
> 改密码、删除账号、双因素、Passkey、手机与邮箱绑定、实名认证，全部拒绝。

> [card] 动不了钱和密钥明文
>
> 充值、提现、支付方式、发票提交一律拒绝；已有 API 密钥的明文也永远取不到。

## 生命周期

* **数量上限**：同一账号最多同时存在 10 枚有效的 Admin Key，每天最多创建 5 枚。
* **可以编辑**：创建之后可以修改名称和作用域。**有效期不可修改** —— 需要换期限请重新创建一枚。
* **随时撤销**：可以单独撤销某一枚，也可以一次撤销全部。撤销立即生效，不可恢复。
* **改密码即全部失效**：修改账号密码会让名下**全部** Admin Key 立即失效，包括选了永不过期的那些。

## 怀疑泄露了怎么办

**1. 立即撤销**

到管理 Key 页面点「撤销全部」。这个动作同时会把你在其他设备上的登录一并登出。

**2. 检查审计日志**

在 **构建与使用 → 审计日志** 里查看这枚 Key 的使用记录，包括首次使用时间和来源 IP。

**3. 重新创建**

用更小的作用域和更短的有效期重新创建，只勾脚本真正用得到的那几项。

> [!NOTE]
>
> 系统会在一枚 Key 频繁触碰能力边界时自动记录审计。持续被拒通常意味着两件事之一：脚本配错了作用域，或者这枚 Key 落到了不知道它边界的人手里。


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