教程

音效快速入门

了解如何使用 Sound Effects API 生成音效。

本指南将介绍如何使用 Sound Effects API 生成音效。

使用 ElevenLabs sound-effects skill，通过 AI 编程助手生成音效：

npx skills add elevenlabs/skills --skill sound-effects

使用 Sound Effects API

1

创建 API 密钥

在控制台创建 API 密钥，用于安全地访问 API。

将密钥存储为托管密钥，并根据需要通过 .env 文件将其作为环境变量传递给 SDK，或直接在应用配置中设置。

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

安装 SDK

我们还会使用 dotenv 库从环境变量加载 API 密钥。

pip install elevenlabs
pip install python-dotenv

如需通过扬声器播放音频，系统可能会提示你安装 MPV 和/或 ffmpeg。

3

发起 API 请求

根据所选语言，新建名为 example.py 或 example.mts 的文件，并添加以下代码：

# example.py
import os
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
load_dotenv()
elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio = elevenlabs.text_to_sound_effects.convert(text="Cinematic Braam, Horror")
play(audio)

然后运行：

python example.py

你应该会听到生成的音效通过扬声器播放。

后续步骤

音效概览

了解音效生成、支持的格式和使用场景

文本转语音

使用文本转语音 API 根据文本生成语音音频

API 参考文档

查看所有 Sound Effects 参数和响应格式