库与 SDK

探索用于 ElevenLabs API 的各语言库。

官方 REST API 库

ElevenLabs 提供官方支持的库,并会随 REST API 的最新功能持续更新。

语言GitHub包管理器
PythonGitHub READMEPyPI
JavaScript(Node)GitHub READMEnpm

发送 SDK 尚未定义的参数

某个字段可能已在 API 中可用,例如作为 beta 功能,但当前 SDK 版本还没有对应的类型化参数。要发送该字段,可在请求选项中将其作为额外的请求体参数传入。SDK 会按原样将这些值合并到 JSON 请求体中,不进行验证。

audio = elevenlabs.text_to_speech.convert(
voice_id="JBFqnCBsd6RMkjVDRZzb",
text="The first move is what sets everything in motion.",
model_id="eleven_multilingual_v2",
request_options={"additional_body_parameters": {"new_field": "value"}},
)

请使用 API 参考文档中的字段名(snake_case)。额外请求体参数会跳过 SDK 的序列化,因此不会转换 TypeScript 属性名。在 TypeScript 中,此选项 需要 @elevenlabs/elevenlabs-js v2.59.0 或更高版本,且仅适用于 JSON 请求体, 不适用于文件上传。SDK 版本包含该参数后,请改用类型化参数。

同一请求选项还支持额外的请求头和查询参数:Python 中使用 additional_headers 和 additional_query_parameters,TypeScript 中使用 headers 和 queryParams。

命令行界面

ElevenLabs CLI 可让你在终端中使用 REST API。推荐通过 Homebrew(macOS)或 Scoop(Windows)安装。

brew install elevenlabs/tap/elevenlabs

正在使用 AI 编程助手?在项目中运行 elevenlabs generate-skills,即可将每个命令组的 SKILL.md 写入 skills/,无需粘贴文档,助手就能了解 CLI 的完整功能。使用 --output-dir 可将其放到其他位置。该命令会读取 CLI 内置的 API 定义,因此无需 API 密钥且可离线运行——还能始终与已安装的 CLI 版本保持同步。

然后进行身份验证——这会打开浏览器,为 CLI 授权:

elevenlabs auth login

官方 Agents Platform 库

这些库专为 ElevenLabs Agents Platform 设计。

语言文档包管理器
JavaScript文档npm
React文档npm
React Native文档npm
Python文档PyPI
Swift文档GitHub
Kotlin文档Maven
Flutter文档Pub

第三方库

这些库不受 ElevenLabs 官方支持,而是由社区维护。

库文档包管理器
Vercel AI SDK文档npm
.NET文档NuGet
Unity文档OpenUPM