# 管理 API 密钥

> URL: https://foura.ai/zh/docs/dashboard/api-keys
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

API Keys 页面用于创建、查看和管理应用程序调用 FourA API 所需的密钥。

## 查看密钥

该页面会显示你有权访问的所有密钥：你的个人密钥，以及你所属组织拥有的所有密钥。成员身份即代表授予访问权限，因此普通成员也可以查看组织的密钥。

| 列 | 显示内容 |
|--------|---------------|
| Name | 显示名称，以及设置的描述（若有） |
| Owner | `Personal`，或组织名称 |
| Key Prefix | 密钥前缀，后接掩码（`pk_live_a1b2••••••••`），附带 Reveal 按钮，旧版密钥则显示锁图标 |
| Status | Active 或 Inactive |
| Created | 密钥创建时间 |
| Last Used | 密钥最近一次发起请求的时间 |

支持按名称或描述搜索，按 Active 或 Inactive 筛选，并按 Name、Owner、Status、Created 或 Last Used 排序。排序方向依次为降序、升序、关闭。

### Owner 筛选器

如果你至少属于一个组织，搜索框旁会显示 **Owner** 下拉菜单：**Everything**、**Personal**，或每个组织对应的选项。它会将列表筛选为归该所有者所有的密钥。Overview、Metrics、Activity 和 Proxy 页面上的相同控件也会联动生效，确保这五个页面始终显示相同实体的流量。

## 创建密钥

点击列表上方的 **Create Key**（创建第一个密钥前，空白页面上显示为 **Create API key**），并填写以下内容：

| 字段 | 是否必填 | 说明 |
|-------|----------|-------------|
| Name | 是 | 描述性标签，例如 "production-scraper" 或 "staging-test" |
| Description | 否 | 关于此密钥用途的备注 |
| Owner | 如果你属于某个组织则必填 | Personal，或你所属的任意组织。仅在你至少属于一个组织时显示选择器。 |

组织的任何成员都可以创建归该组织所有的密钥，无论其角色为何。该设置的核心意义在于：组织密钥产生的用量将向组织所有者计费，开发者无需使用个人密钥而为公司流量垫付费用。

创建完成后，完整密钥仅在弹出的对话框中展示一次，可直接复制。之后你可以通过 **Reveal** 再次查看。密钥使用 `pk_live_` 前缀，格式类似于 `pk_live_a1b2c3d4e5f6...`。你将收到一封确认密钥已创建的电子邮件。

你拥有的有效密钥配额由套餐决定：包含你的个人密钥以及你所拥有组织的密钥。为组织创建的密钥计入该组织所有者的套餐配额。达到上限后，系统将拒绝创建密钥并提示套餐配额限制，此时可停用或删除不再使用的密钥，或者升级套餐。

## 显示密钥完整内容

点击密钥掩码前缀旁的眼睛图标，即可重新查看完整密钥。控制台会要求确认，然后打开一个对话框，其中包含明文密钥、复制按钮和简短倒计时。倒计时结束后，对话框将从页面中清除该密钥。

由于该操作暴露了有效凭据，每次显示操作都会记录在审计日志中。

任何与其共享密钥的人都可以查看该密钥：其个人所有者，或拥有该密钥的组织的任何成员。

### 旧版密钥

在查看功能上线前创建的密钥会显示锁定图标而非眼睛图标，且无法查看。系统仅存储了这些密钥的哈希值，因此原始密钥无法恢复。若要转换旧版密钥，请打开操作菜单并选择 **Regenerate**。新生成的密钥此后均可查看。

## 各角色的权限

对于个人密钥，你可以执行所有操作。对于组织密钥，适用以下三个权限级别：

| 操作 | 成员 | 管理员 | 所有者 |
|--------|--------|-------|-------|
| 使用密钥并查看 | 是 | 是 | 是 |
| 重命名、编辑描述 | 是 | 是 | 是 |
| 启用或停用 | 否 | 是 | 是 |
| 重新生成密钥 | 否 | 是 | 是 |
| 删除密钥 | 否 | 是 | 是 |
| 移出组织 | 否 | 否 | 是 |

Disable 和 Edit 仍保留在行中，但会显示为灰色并附带原因说明。当你的角色无权使用 Regenerate、Transfer 和 Delete 时，这些选项不会出现在菜单中。API 同样会拒绝这些操作，因此集成无法绕过界面限制。

权限划分取决于各项操作对密钥共享成员产生的影响。重命名没有任何破坏性。重新生成或停用会立即中断所有同事的相关集成。将密钥移出会将其从公司收回，并将其用量计入接收者自己的套餐，因此该操作仅限所有者执行。

## 编辑密钥

点击 **Edit** 可更新名称和描述。此对话框中不能更改所有权：请使用 **Transfer**。

操作菜单中的 **View Metrics** 会打开按该密钥筛选的 Overview。

## 启用和停用

使用行操作中的 **Disable** 或 **Enable**。停用密钥会阻止使用它的所有 API request，你可以随时重新启用它。更改会在一分钟内生效。

## 重新生成密钥

如果你怀疑密钥已泄露，请打开操作菜单并选择 **Regenerate**。这将为相同的密钥 ID 创建新的 secret。旧的 secret 会在一分钟内失效。名称、所有者和所有其他设置均保持不变。

对话框关闭后，新 secret 仍可查看，因此无需在首次弹出时必须一次性复制成功。

## 转移密钥

操作菜单中的 **Transfer** 可在个人和组织所有权之间转移密钥，无需重新生成 secret。密钥 ID、指标和活动历史记录均会保留。仅所有者发生更改，账单结算对象也随之变更。

| 转移类型 | 操作权限所有者 |
|------|---------------|
| 个人密钥转入组织 | 该组织的任何成员 |
| 组织密钥转出至个人 | 组织所有者 |
| 在两个组织之间转移 | 密钥转出方组织的所有者 |

转入组织的密钥会加入其默认的 "Everyone" 团队，使组织成员均可见。转出的密钥将退出其之前所在的所有团队。

## 删除密钥

打开操作菜单并选择**删除**。删除曾使用过的密钥会将其停用：该密钥将停止身份验证，并作为**非活跃**状态保留在列表中，以便其活动和指标历史记录保留其名称。从未使用的密钥会被彻底移除。

密钥被删除时，您会收到一封电子邮件。

## 组织密钥与结算

无论请求由谁发起，组织拥有的密钥的使用量都会计入**组织所有者**的套餐。所有者的 [使用量与限额](https://foura.ai/docs/dashboard/quota) 页面会将这些密钥与其个人密钥并列统计，并将两者分开展示。

## 相关内容

- [身份验证](https://foura.ai/docs/getting-started/authentication)：API 密钥如何配合 API 工作
- [组织](https://foura.ai/docs/dashboard/teams-and-orgs)：角色、成员及共享访问权限
- [使用量与限额](https://foura.ai/docs/dashboard/quota)：哪些密钥会计入您的套餐
- [控制面板概览](https://foura.ai/docs/dashboard/overview)：所有控制面板板块
