教程

变声器快速入门

了解如何使用变声器 API 转换音频文件中的声音。

本指南将介绍如何使用变声器 API 转换音频文件中的声音。

使用 ElevenLabs voice-changer skill，通过 AI 编程助手转换音频文件中的声音：

npx skills add elevenlabs/skills --skill voice-changer

使用变声器 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
import requests
from io import BytesIO
load_dotenv()
elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)
voice_id = "JBFqnCBsd6RMkjVDRZzb"
audio_url = (
    "https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3"
)
response = requests.get(audio_url)
audio_data = BytesIO(response.content)
audio_stream = elevenlabs.speech_to_speech.convert(
    voice_id=voice_id,
    audio=audio_data,
    model_id="eleven_multilingual_sts_v2",
    output_format="mp3_44100_128",
)
play(audio_stream)

然后运行：

python example.py

应该会听到扬声器播放转换后的声音。

后续步骤

浏览音色

浏览超过 10,000 种音色，将其用作转换的目标声音

克隆声音

根据一小段录音创建自定义声音，用作目标声音

API 参考文档

查看所有变声器参数和响应格式