你的 API 密钥就像一个密码:有了它,你的 AI 代理或程序才能使用你账户下的 API,每一次调用都会算在你的账上。一个密钥可以用在 Zyla API Hub 上的所有 API、Zyla MCP 服务器,以及 Listings API。
如果你是通过 AI 代理来用的,基本不用管这个密钥:连接 AI 代理(MCP) 里的那条设置命令已经自动包含了它。
获取你的密钥
- 注册 或 登录。
- 打开 连接 AI 代理(MCP)。你的密钥会显示在 您的 API 访问密钥 里,旁边有一个 Copy 按钮。所有密钥也可以在账户菜单的 API keys 里找到。
在代码里使用它
开发者可以把它放进每个请求的 Authorization 请求头:
Authorization: Bearer YOUR_API_KEY
创建更多密钥
从账户菜单打开 API keys(/api_keys),你可以:
- 创建带名称的新密钥,比如给每个项目或环境各建一个;
- 把某个密钥限制到指定的 API,这样密钥泄露了也不会连累你其他的订阅;
- 随时撤销一个密钥,用已撤销的密钥发出的请求会收到
401。
被限制到部分 API 的密钥去调用列表之外的 API 时会收到 403。
保管好你的密钥
- 不要把密钥放进客户端代码里(浏览器 JavaScript、手机应用),请从你的后端调用 Zyla。
- 不要把它提交到代码仓库里,从环境变量或密钥管理工具里读取它。
- 如果密钥泄露了,去 API keys 撤销它,再创建一个新的。