用途：在 Node.js 或 Python 项目中安装 ElevenLabs 官方 SDK，并配置基于 API Key 的认证。ElevenLabs 所有端点位于 api.elevenlabs.io，统一使用 xi-api-key 请求头认证。
前提条件：Node.js 18+ 或 Python 3.10+；ElevenLabs 账号（免费版可用）；在仪表盘 Profile > API Keys 获取 API Key。
安装：Node.js 使用 npm install @elevenlabs/elevenlabs-js 或 pnpm add @elevenlabs/elevenlabs-js；Python 使用 pip install elevenlabs。
配置密钥：设置环境变量 export ELEVENLABS_API_KEY="sk_your_key_here"，或写入 .env 文件，并将 .env、.env.local、.env.*.local 加入 .gitignore。
初始化客户端：两种 SDK 均自动读取 ELEVENLABS_API_KEY。TypeScript 示例：import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js"; const client = new ElevenLabsClient({ apiKey: process.env.ELEVENLABS_API_KEY }); Python 客户端对应写法为 ElevenLabsClient(api_key=...)。重试、超时与完整 Python 骨架见 implementation.md。
验证连接：通过列出语音确认认证有效，例如 const voices = await client.voices.getAll(); 成功调用说明密钥有效且未超配额。完整 TypeScript、Python 与 cURL 验证（含订阅与配额检查）见 implementation.md。
输出：SDK 安装到 node_modules 或 site-packages；API Key 存入被 git 忽略的 .env；成功列出语音即确认认证；显示订阅层级与字符配额。
错误处理：invalid_api_key（401）表示密钥缺失、过期或格式错误，需在仪表盘重新生成；ENOTFOUND api.elevenlabs.io 为 DNS/网络故障，检查网络并确保 443 端口出站 HTTPS；MODULE_NOT_FOUND 表示 SDK 未安装，运行 npm install @elevenlabs/elevenlabs-js；quota_exceeded（401）表示计费周期字符数已达上限，需升级或等待重置。
密钥最佳实践：不要在源码中硬编码密钥；开发、预发、生产使用不同密钥；每季度通过仪表盘轮换密钥。资料提到免费版每月 10,000 字符、Starter 30,000、Creator 100,000。
后续步骤：认证确认后，可继续使用 elevenlabs-hello-world 技能进行首次文本转语音，并探索语音列表与流式传输。