跳到导航
教程

ElevenAPI 快速入门

了解如何发起首次 ElevenLabs API 请求。

完成本指南后，你将在项目中完成 ElevenLabs 设置，并能发起首次文本转语音请求。有两种方式：让编程智能体完成设置，或手动设置。

如需了解其他功能的指南，例如流式传输、语音克隆、语音转文本，请查看 教程部分。

使用编程智能体设置

开始前无需账户或 API 密钥。将以下内容粘贴到编程智能体中：

Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.

之后 ElevenLabs CLI 会继续操作，并将每一步告知智能体。浏览器会打开一次，以便你登录或创建账户并点击 授权。密钥会保存到项目的 env 文件（.env.local，Python 项目中为 .env），不会提交到 git，也绝不会显示在聊天中。接着，智能体会询问你想构建什么，安装 SDK，将代码添加到应用，并询问是否发送测试请求。

如果智能体运行在浏览器无法访问的位置，例如通过 SSH 连接的远程机器或 云端沙盒，CLI 会要求你自行创建密钥，并将其粘贴到 env 文件中，然后继续。该命令需要 Node.js 才能使用 npx。如果没有 Node.js， 可通过 Homebrew（macOS 和 Linux）或 Scoop（Windows）安装 ElevenLabs CLI， 如果已安装，则进行更新（brew upgrade elevenlabs、 scoop update elevenlabs），然后让智能体改为运行 elevenlabs onboard init。

手动设置

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

发起首次请求

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

from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import os
load_dotenv()
elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio = elevenlabs.text_to_speech.convert(
    text="The first move is what sets everything in motion.",
    voice_id="JBFqnCBsd6RMkjVDRZzb",  # "George" - browse voices at elevenlabs.io/app/voice-library
    model_id="eleven_v4",
    output_format="mp3_44100_128",
)
play(audio)

然后运行：

python example.py

应能听到音频通过扬声器播放。

后续步骤

流式传输音频

在生成时流式传输音频，无需等待完整文件，以降低延迟

浏览音色

探索超过 10,000 个音色，并将示例音色 ID 替换为适合用例的音色

克隆音色

通过一段简短录音创建自定义音色