ElevenLabs API密钥设置指南：快速配置语音合成API密钥与环境变量

setup-api-key by elevenlabs/skills

1,300 周安装量

142 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/elevenlabs/skills --skill setup-api-key

AI/机器学习开发音频处理

🇨🇳中文介绍

ElevenLabs API 密钥设置

引导用户获取并配置 ElevenLabs API 密钥。

工作流程

步骤 0：首先检查是否存在现有的 API 密钥

在向用户索要密钥之前，先检查是否存在现有的 ELEVENLABS_API_KEY：

检查当前环境中是否存在 ELEVENLABS_API_KEY。
如果环境中没有，检查 .env 文件中是否有 ELEVENLABS_API_KEY=<value>。

如果找到现有密钥，验证它：

GET https://api.elevenlabs.io/v1/user
Header: xi-api-key: <existing-api-key>

如果现有密钥验证成功：
- 告知用户 ElevenLabs 已配置完成且正常工作
- 跳过设置流程
- 询问他们是否要更换/轮换密钥；如果不需要，则停止

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

705,000 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

245,300 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

196,800 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

128,699 周安装

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

通过发起请求来验证密钥：

GET https://api.elevenlabs.io/v1/user
Header: xi-api-key: <the-api-key>

如果验证失败：
- 告知用户 API 密钥似乎无效
- 请他们再试一次
- 提醒他们 URL：https://elevenlabs.io/app/settings/api-keys
- 如果第二次失败，则显示错误并退出
如果验证成功，将 API 密钥保存在 .env 文件中：
```
ELEVENLABS_API_KEY=<the-api-key>
```
- 如果 .env 文件中已有 ELEVENLABS_API_KEY=...，则替换该行
- 否则为 ELEVENLABS_API_KEY 添加新行
确认成功：

🇺🇸English

ElevenLabs API Key Setup

Guide the user through obtaining and configuring an ElevenLabs API key.

Workflow

Step 0: Check for an existing API key first

Before asking the user for a key, check for an existing ELEVENLABS_API_KEY:

Check whether ELEVENLABS_API_KEY exists in the current environment.
If it's not in the environment, check .env for ELEVENLABS_API_KEY=<value>.

If an existing key is found, validate it :

GET https://api.elevenlabs.io/v1/user
Header: xi-api-key: <existing-api-key>

If existing key validation succeeds:
- Tell the user ElevenLabs is already configured and working
- Skip the setup flow
- Ask whether they want to replace/rotate the key; if not, stop
If existing key validation fails:
- Tell the user the existing key appears invalid or expired
- Continue to Step 1

Step 1: Request the API key

Tell the user:

To set up ElevenLabs, open the API keys page: https://elevenlabs.io/app/settings/api-keys

(Need an account? Create one at https://elevenlabs.io/app/sign-up first)

If you don't have an API key yet:

Click "Create key"

Name it (or use the default)

Set permission for your key. If you provide a key with "User" permission set to "Read" this skill will automatically verify if your key works

Click "Create key" to confirm

Copy the key immediately - it's only shown once!

Paste your API key here when ready.

Then wait for the user's next message which should contain the API key.

Step 2: Validate and configure

Once the user provides the API key:

Validate the key by making a request:

GET https://api.elevenlabs.io/v1/user
Header: xi-api-key: <the-api-key>

If validation fails:
- Tell the user the API key appears to be invalid
- Ask them to try again
- Remind them of the URL: https://elevenlabs.io/app/settings/api-keys
- If it fails a second time, display an error and exit
If validation succeeds , save the API key in a .env file:
```
ELEVENLABS_API_KEY=<the-api-key>
```
- If .env already has ELEVENLABS_API_KEY=..., replace that line
- Otherwise add a new line for ELEVENLABS_API_KEY

Done! Your key is stored as an environment variable in .env Keep the key safe! Don't share it with anyone!

Weekly Installs

1.3K

Repository

elevenlabs/skills

GitHub Stars

142

First Seen

Jan 27, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykFail

Installed on

codex969

gemini-cli958

opencode948

claude-code901

github-copilot849

kimi-cli794