# API 密钥

创建一把密钥，让你自己的 AI 智能体或脚本可以使用 SimianX AI；复制一次，限制它能花多少，并可以撤销它。

- 所有套餐。密钥的数量取决于你的套餐。
- 创建密钥免费。密钥运行的一切都消耗你账户的点数。

API 密钥让 AI 智能体或脚本可以不用你的密码，就以你的账户使用 SimianX AI。本页讲的是密钥本身。

## 创建密钥

1. 打开账户菜单，选择 **我的账户**，然后打开 **API 密钥** 标签页。
2. 选择 **创建密钥**。**新建 API 密钥** 表单打开。
3. 输入一个 **名称**，让你知道这把密钥用在哪里。
4. 在 **这把密钥可以做什么** 下面，选择这把密钥可以做什么：读取市场数据和新闻、运行分析、管理自动驾驶、管理密钥。前三项默认已选。没有运行分析的权限，密钥可以读取数据，但不能开始分析。
5. 可选：设置 **每日预算（点）**、**每月预算（点）** 或 **单次调用上限（点）**。留空表示没有上限。
6. 可选：填写 **使用的 Agent**、**IP 白名单**（每行一个地址）和 **过期时间**。
7. 选择 **创建密钥**。

![“新建 API 密钥”表单，有“名称”栏、权限选项、三个可选的点数预算栏、“使用的 Agent”栏、“IP 白名单”框、“过期时间”列表和“创建密钥”按钮。](https://fw.simianx.ai/help/zh-CN/account-api-key-form.light.90989c4094.webp)

*“新建 API 密钥”表单*

## 复制密钥

**你的新密钥** 窗口显示完整的密钥。选择 **复制**，把密钥保存到你的智能体或密码管理器里，然后选择 **完成**。

> **不能撤销**
> 完整的密钥只显示这一次。SimianX AI 只保存哈希值，无法再次显示它。如果你弄丢了密钥，请撤销它并创建一把新的。

![“你的新密钥”窗口。里面有四行，每行都有“复制”按钮：完整的密钥、把它设为智能体环境变量的一行、一句让智能体自行完成设置的话，以及一条测试密钥的命令。底部是“完成”按钮。](https://fw.simianx.ai/help/zh-CN/account-api-key-token.light.f7d9473fcb.webp)

*密钥只显示一次*

## 查看列表

每把密钥显示它的名称、开头几个字符、今天和本月花掉的点数、它的预算，以及上次使用的时间。

- **用量**：最近 7 天的请求和点数，按接口分。
- **编辑**：更改名称、权限、预算、Agent 和 IP 白名单。更改从下一次请求起生效。
- **撤销**：让密钥失效。

## 撤销密钥

1. 在密钥那一行上选择 **撤销**。
2. 在 **撤销这把密钥？** 对话框里，选择 **撤销**。

> **不能撤销**
> 使用已撤销密钥的请求会立刻失效，密钥也无法恢复。这把密钥启动的自动驾驶会继续在你的账户下运行。需要的话，请在 **自动驾驶仪** 页面停止它们。

## 点数

> **会消耗点数**
> 密钥花的是你账户的点数，费率和网站上一样。请给每把密钥设一个预算，这样一个智能体花的不会超过你允许的数量。参见[点数与费率](https://www.simianx.ai/zh-CN/points)。

## 值得了解

- 这个标签页显示你有多少把密钥，以及你的套餐允许多少把。达到上限时，**创建密钥** 不能点：请撤销一把密钥，或者[更换套餐](https://www.simianx.ai/zh-CN/help/points-and-plans/change-plan.md)。
- 智能体也可以自己申请密钥：它给你一个链接，由你批准或拒绝。参见[接入你自己的 AI 智能体](https://www.simianx.ai/zh-CN/help/market-tools/connect-ai-agent.md)。
- 密钥不能登录网站，也不能更改你的订阅或付款信息。

---

网页: https://www.simianx.ai/zh-CN/help/account/api-keys
章节: [账户](https://www.simianx.ai/zh-CN/help/account.md)
完整手册: https://www.simianx.ai/zh-CN/help/manual.md