跳到导航
API reference

API 身份验证

了解如何验证 ElevenLabs API 请求

API 密钥

无需手动配置密钥，让编码智能体帮你完成。

将以下内容粘贴到 Claude Code、Cursor 或 Codex。它会帮你登录或创建账户、创建密钥，并将 SDK 添加到项目中。

Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.

了解其工作方式，或者阅读 onboard 命令的源代码，查看它会具体向智能体发送什么内容。

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

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

  1. 范围限制： 通过限制密钥可访问的 API 端点来设置访问权限。
  2. 额度配额： 设置自定义额度上限以控制用量。
  3. IP 允许列表： 将密钥限制为特定 IP 地址或 CIDR 范围。来自不在允许列表中的 IP 的请求会被拒绝，并返回 403 错误。了解更多。

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

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

xi-api-key: ELEVENLABS_API_KEY

发起请求

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

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

使用 elevenlabs Python 包的示例：

from elevenlabs.client import ElevenLabs
elevenlabs = ElevenLabs(
  api_key='YOUR_API_KEY',
)

使用 elevenlabs Node.js 包的示例：

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});

一次性令牌

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

更多信息请参阅一次性令牌文档。