项目介绍:elevenlabs-python
概述
elevenlabs-python
是 ElevenLabs 公司推出的官方 Python API,旨在为创作者和开发者提供最具表现力、丰富且逼真的语音合成功能。通过这几个简单的代码行,用户可以轻松地将文字转化为语音。
API 文档
ElevenLabs 提供了详细的 HTTP API 文档,帮助用户更好地理解和使用该 API。用户可以从中了解到如何调用 API 以实现文字转语音的功能。
安装指导
使用 Python 包管理工具 pip 安装非常简便,只需在命令行中输入以下命令:
pip install elevenlabs
主要模型
-
Eleven Multilingual v2 (
eleven_multilingual_v2
): 在稳定性、语言多样性和口音准确性方面表现出色,支持29种语言,适合大多数使用场景。 -
Eleven Turbo v2.5 (
eleven_turbo_v2_5
): 提供高质量且最低延迟的语音合成,支持32种语言,适合对速度要求高的开发者使用场景。
使用示例
以下是如何使用该库生成语音的简单示例:
from elevenlabs import play
from elevenlabs.client import ElevenLabs
client = ElevenLabs(api_key="YOUR_API_KEY") # 可以替换为您自己的 API 密钥
audio = client.generate(
text="Hello! 你好! Hola! नमस्ते! Bonjour! こんにちは! مرحبا! 안녕하세요! Ciao! Cześć! Привіт! வணக்கம்!",
voice="Brian",
model="eleven_multilingual_v2"
)
play(audio)
获取可用的声音
用户可以通过 voices()
方法来列出所有可用的声音设置,并可以获取到默认的声音设置或创建自定义的声音对象:
from elevenlabs.client import ElevenLabs
client = ElevenLabs(api_key="YOUR_API_KEY")
response = client.voices.get_all()
audio = client.generate(text="Hello there!", voice=response.voices[0])
print(response.voices)
克隆声音
ElevenLabs 支持语音克隆,用户只需提供示例音频文件,即可在几秒钟内生成一个新的克隆声音:
from elevenlabs.client import ElevenLabs
from elevenlabs import play
client = ElevenLabs(api_key="YOUR_API_KEY")
voice = client.clone(
name="Alex",
description="An old American male voice with a slight hoarseness in his throat. Perfect for news",
files=["./sample_0.mp3", "./sample_1.mp3", "./sample_2.mp3"]
)
audio = client.generate(text="Hi! I'm a cloned voice!", voice=voice)
play(audio)
流媒体功能
ElevenLabs 支持实时流式生成音频,允许在生成过程中直接播放:
from elevenlabs.client import ElevenLabs
from elevenlabs import stream
client = ElevenLabs(api_key="YOUR_API_KEY")
audio_stream = client.generate(
text="This is a... streaming voice!!",
stream=True
)
stream(audio_stream)
支持的语言
ElevenLabs 支持32种语言和超过100种口音,满足多语言和多文化背景的需求。
贡献指南
尽管 elevenlabs-python
主要通过程序生成,ElevenLabs 仍然欢迎社区成员对其 README 文档做出贡献。在提出修改建议前,建议先通过开放问题(issue)与团队沟通。
通过这样一个简洁而功能强大的 API,ElevenLabs 为语音用户提供了一个高效的解决方案,极大地简化了文字转语音的开发流程。