用途:实现 ElevenLabs 的文本转语音(TTS)与声音克隆工作流,适用于构建 TTS 功能、从音频样本克隆声音、向应用流式输出语音以及管理语音库。
主要能力:一、高级文本转语音,实例化客户端后调用 textToSpeech.convert(voiceId, opts),将返回流写入文件,通过 voice_settings 调节 stability、similarity_boost、style、speed,可选 language_code。二、即时声音克隆(IVC),用 1-25 个音频样本调用 client.voices.add({ name, description, files }),返回可立即使用的 voice_id,克隆声音建议 similarity_boost 设为 0.85。三、WebSocket 流式 TTS,连接 wss://api.elevenlabs.io/v1/text-to-speech/{voiceId}/stream-input,使用低延迟模型 eleven_flash_v2_5,先发送空格表示流开始,再发送文本块,最后发送空字符串表示流结束,收集 base64 音频帧直到 isFinal。四、语音管理,用 client.voices.getAll()、getSettings、editSettings、delete 列出、查看、更新和删除语音。
使用方式:需先完成 elevenlabs-install-auth 配置,并持有有效 API key 与足够字符配额;克隆需目标声音的干净录音,至少 30 秒。
限制与错误:单次请求文本上限 5000 字符,超出需拆分并用 previous_text/next_text 保持语调;voice_not_found 返回 404,需先列出语音;quota_exceeded 返回 401;并发超限返回 429;克隆样本无效返回 400;WebSocket 不支持 eleven_v3,需改用 eleven_flash_v2_5 或 eleven_multilingual_v2。克隆、流式与管理的完整代码见 implementation.md,示例见 references/examples.md。