elevenlabs-python

项目介绍：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)