# 你的 API 密钥

你的 API 密钥就像一个密码：有了它，你的 AI 代理或程序才能使用你账户下的 API，每一次调用都会算在你的账上。一个密钥可以用在 Zyla API Hub 上的所有 API、Zyla MCP 服务器，以及 Listings API。

如果你是通过 AI 代理来用的，基本不用管这个密钥：[连接 AI 代理（MCP）](https://zylalabs.com/zh/docs/mcp) 里的那条设置命令已经自动包含了它。

## 获取你的密钥

1. [注册](https://zylalabs.com/zh/register) 或 [登录](https://zylalabs.com/zh/login)。
2. 打开 [连接 AI 代理（MCP）](https://zylalabs.com/zh/docs/mcp)。你的密钥会显示在 **您的 API 访问密钥** 里，旁边有一个 **Copy** 按钮。所有密钥也可以在账户菜单的 **API keys** 里找到。

## 在代码里使用它

开发者可以把它放进每个请求的 `Authorization` 请求头：

```http
Authorization: Bearer YOUR_API_KEY
```

## 创建更多密钥

从账户菜单打开 **API keys**（[/api_keys](https://zylalabs.com/zh/api_keys)），你可以：

- 创建带名称的新密钥，比如给每个项目或环境各建一个；
- 把某个密钥限制到指定的 API，这样密钥泄露了也不会连累你其他的订阅；
- 随时撤销一个密钥，用已撤销的密钥发出的请求会收到 `401`。

被限制到部分 API 的密钥去调用列表之外的 API 时会收到 `403`。

## 保管好你的密钥

- 不要把密钥放进客户端代码里（浏览器 JavaScript、手机应用），请从你的后端调用 Zyla。
- 不要把它提交到代码仓库里，从环境变量或密钥管理工具里读取它。
- 如果密钥泄露了，去 **API keys** 撤销它，再创建一个新的。


---
Source: https://zylalabs.com/zh/docs/api-keys
