关于 setup-api-key
setup-api-key 是用于配置 ElevenLabs API 密钥的技能。它会先检查并验证现有密钥,再引导获取新密钥,并将有效密钥写入 `.env`。
主要功能
- 01检查环境变量和 `.env`
- 02通过用户接口验证密钥
- 03引导创建密钥
- 04在 `.env` 中保存或替换密钥
适用场景
- 01检查现有 ElevenLabs 配置
- 02配置新创建的 API 密钥
- 03替换无效或过期的密钥
- 04轮换可用密钥
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ calesthio/ openmontage --skill setup-api-key安装后在 Claude Code 中输入/setup-api-key确认已加载。
详细介绍
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 已配置且可正常使用
- 跳过设置流程
- 询问用户是否要替换或轮换密钥;如果不需要,则停止
- 如果现有密钥验证失败:
- 告知用户现有密钥似乎无效或已过期
- 继续步骤 1
步骤 1:索取 API 密钥
告知用户:
要设置 ElevenLabs,请打开 API 密钥页面:https://elevenlabs.io/app/settings/api-keys
(还没有账户?请先在 https://elevenlabs.io/app/sign-up 创建账户)
如果你还没有 API 密钥:
- 点击“Create key”
- 为其命名(或使用默认名称)
- 设置密钥权限。如果你提供的密钥将“User”权限设为“Read”,此技能会自动验证密钥是否可用
- 点击“Create key”确认
- 立即复制密钥——它只会显示一次!
准备好后,请在此处粘贴 API 密钥。
然后等待用户发送下一条消息,其中应包含 API 密钥。
步骤 2:验证并配置
用户提供 API 密钥后:
-
通过发起请求验证密钥:
GET https://api.elevenlabs.io/v1/user Header: xi-api-key: <the-api-key> -
如果验证失败:
- 告知用户 API 密钥似乎无效
- 请他们重试
- 提醒他们该网址:https://elevenlabs.io/app/settings/api-keys
- 如果第二次仍失败,则显示错误并退出
-
如果验证成功,将 API 密钥保存到
.env文件中:ELEVENLABS_API_KEY=<the-api-key>- 如果
.env中已有ELEVENLABS_API_KEY=...,则替换该行 - 否则,新增一行
ELEVENLABS_API_KEY
- 如果
-
确认成功:
完成!你的密钥已作为环境变量存储在 .env 中 请妥善保管密钥!不要与任何人分享!
评论
支持 Markdown