用途:根据文字描述生成音效,适合制作环境音、界面提示音、影视氛围声和音频纹理。
主要能力:通过 ElevenLabs 的文本转音效接口生成音频;可用参数包括 model_id(默认 eleven_text_to_sound_v2)、duration_seconds(0.5–30 秒,默认 null 自动计算)、prompt_influence(0–1,默认 0.3,控制贴合提示词的程度)、loop(仅 v2 模型支持无缝循环)。输出格式可指定,常见有 mp3_44100_128(默认)、pcm_44100、opus_48000_128、ulaw_8000 等,完整列表见资料。
使用方式:需先按安装指南完成配置,JavaScript 仅使用 @elevenlabs/* 包。Python 示例:client.text_to_sound_effects.convert(text="Thunder rumbling in the distance with light rain"),再将返回的音频分块写入文件。JavaScript 通过 @elevenlabs/elevenlabs-js 创建客户端后调用 client.textToSoundEffects.convert 并管道写入文件。CLI 命令:elevenlabs text-to-sound-effects convert --text "Thunder rumbling in the distance with light rain" --output thunder.mp3。带参数示例:duration_seconds=10.0、prompt_influence=0.5、loop=True 生成循环森林环境音;时长 1 秒、prompt_influence=0.8 生成短提示音。
提示词建议:描述尽量具体(如“Heavy rain on a tin roof”优于“Rain”),可组合元素、指定风格与情绪背景。
限制与错误:duration_seconds 需在 0.5–30 秒范围,prompt_influence 需在 0–1 范围,loop 仅 v2 模型可用。常见错误包括 401 无效 API 密钥、422 参数无效、429 超出速率限制。API 密钥与安装细节见安装指南,资料未提供具体收费与配额信息。