> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# API 身份验证

## API 密钥

> **Tip**
>
> 无需手动配置密钥，让编码智能体帮你完成。
>
> 将以下内容粘贴到 Claude Code、Cursor 或 Codex。它会帮你登录或创建账户、创建密钥，并将 SDK 添加到项目中。
>
> ```text
> Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.
> ```
>
> [了解其工作方式](/docs/zh/eleven-api/quickstart#set-up-with-your-coding-agent)，或者阅读 [`onboard` 命令的源代码](https://github.com/elevenlabs/cli/tree/main/cli/elevenlabs/workflow/onboard)，查看它会具体向智能体发送什么内容。

ElevenLabs API 使用 API 密钥进行身份验证。每个 API 请求都必须包含 API 密钥，用于验证请求身份并跟踪用量配额。

每个 API 密钥可配置以下限制：

1. **范围限制：** 通过限制密钥可访问的 API 端点来设置访问权限。
2. **额度配额：** 设置自定义额度上限以控制用量。
3. **IP 允许列表：** 将密钥限制为特定 IP 地址或 CIDR 范围。来自不在允许列表中的 IP 的请求会被拒绝，并返回 `403` 错误。[了解更多](/docs/zh/overview/administration/workspaces/api-keys#ip-allowlisting)。

**请注意，API 密钥属于机密信息。** 不要与他人共享，也不要将其暴露在任何客户端代码中（浏览器、应用）。

所有 API 请求都应按以下方式在 `xi-api-key` HTTP 标头中包含 API 密钥：

```bash
xi-api-key: ELEVENLABS_API_KEY
```

### 发起请求

可将以下命令粘贴到终端，运行第一个 API 请求。请务必将 `$ELEVENLABS_API_KEY` 替换为私密 API 密钥。

```bash
curl 'https://api.elevenlabs.io/v1/models' \
  -H 'Content-Type: application/json' \
  -H 'xi-api-key: $ELEVENLABS_API_KEY'
```

使用 `elevenlabs` Python 包的示例：

```python
from elevenlabs.client import ElevenLabs

elevenlabs = ElevenLabs(
  api_key='YOUR_API_KEY',
)
```

使用 `elevenlabs` Node.js 包的示例：

```javascript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});
```

### 一次性令牌

对于某些端点，可使用一次性令牌验证请求。这些令牌的有效期有限，可用于连接 API 而不暴露 API 密钥，例如从客户端发起连接。

更多信息请参阅[一次性令牌](/docs/zh/api-reference/tokens/create)文档。