setup-api-key

ElevenLabs API 密钥设置

适用于用户已有的密钥，或已失效的密钥。要从头开始将 ElevenLabs 添加到项目中，请使用 onboarding 技能。

用户已有的密钥（例如管理员提供的密钥）： 不要登录获取新密钥。告诉用户将密钥粘贴到使用它的应用环境文件中的 ELEVENLABS_API_KEY= 后面（.env.local，或 Python 项目中的 .env），切勿粘贴到此聊天中，并让他们完成后告知你。然后检查密钥（如果 check 未找到密钥，或 ElevenLabs 拒绝该密钥并提示登录，请让用户检查粘贴是否正确，不要登录）：

npx -y @elevenlabs/cli@latest onboard check

已失效的密钥： 在应用目录中运行同一条命令。它会找到应用将使用的密钥（来自 shell、环境文件或目录树中上级目录里的 .env），在不打印密钥的情况下通过 ElevenLabs 检查密钥，并输出 JSON：next 是步骤（具体说明见 instruction；如果下方列表与其不同，请遵循下方列表），run 是要运行的确切命令，say 是要告诉用户的内容（按原文告知）。按照指示操作，直到密钥可用；如果密钥被拒绝，则会让用户登录获取新密钥。各个 next 的含义：

• run：运行 run。wait：显示 say，然后立即再次运行 run。
• ask_user，或需要用户提供 shell 或机密信息的 fix：询问用户 say 中的内容，等待他们回答，然后运行 run，除非他们拒绝。
• write_code：如果应用已经读取 ELEVENLABS_API_KEY（通过 SDK 或自行发送请求），不要修改代码：connect 后运行 run；check 后告诉用户密钥可用（不要说 say 中的内容），然后停止。否则，确保代码使用 SDK，然后运行 run；如果没有任何内容说明应用应该如何使用 ElevenLabs，请先询问用户，不要替他们选择产品。
• offer_test：询问 say 中的问题；只有用户同意后才运行 run。
• done：告诉用户 say 中的内容。

规则

• 切勿打开、打印或使用 cat 查看环境文件，也不要回显 ELEVENLABS_API_KEY；onboard check 会替你验证密钥。
• 切勿在聊天中索要 API 密钥，也不要接受用户在聊天中粘贴的密钥。如果用户粘贴了密钥，告诉他们前往 API keys 页面轮换密钥。
• 切勿将密钥写入代码；SDK 会读取 ELEVENLABS_API_KEY。
• 未经用户同意，不要运行应用（或其启动脚本），也不要生成语音进行测试。用户要求执行的 API 调用（例如创建 Agent）可以进行。代码编写完成后，结束前运行 onboard check：它会验证密钥和代码。
• 对于浏览器或客户端应用，请将密钥保存在服务器端，并在产品支持的情况下签发短期令牌。

不使用 npx

如果无法使用 npx（未安装 Node.js），请安装 CLI（如果已安装，则更新：运行 brew upgrade elevenlabs，或重新运行安装程序），然后运行 elevenlabs onboard check：

• macOS 或 Linux：brew install elevenlabs/tap/elevenlabs，或 curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
• Windows：powershell -ExecutionPolicy ByPass -c "irm https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.ps1 | iex"

如果安装程序运行后仍找不到 elevenlabs，请在此处以及 CLI 提供的每条 run 命令中改用 ~/.cargo/bin/elevenlabs。