> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 库与 SDK

## 官方 REST API 库

ElevenLabs 提供官方支持的库，并会随 [REST API](/docs/zh/api-reference/introduction) 的最新功能持续更新。

| 语言               | GitHub                                                           | 包管理器                                                           |
| ---------------- | ---------------------------------------------------------------- | -------------------------------------------------------------- |
| Python           | [GitHub README](https://github.com/elevenlabs/elevenlabs-python) | [PyPI](https://pypi.org/project/elevenlabs/)                   |
| JavaScript（Node） | [GitHub README](https://github.com/elevenlabs/elevenlabs-js)     | [npm](https://www.npmjs.com/package/@elevenlabs/elevenlabs-js) |

### 发送 SDK 尚未定义的参数

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

**`Python`**

```python title="Python"
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"}},
)
```

**`TypeScript`**

```typescript title="TypeScript"
const audio = await elevenlabs.textToSpeech.convert(
  "JBFqnCBsd6RMkjVDRZzb",
  {
    text: "The first move is what sets everything in motion.",
    modelId: "eleven_multilingual_v2",
  },
  { additionalBodyParameters: { new_field: "value" } }
);
```

> **Note**
>
> 请使用 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](/docs/zh/eleven-agents/operate/cli) 可让你在终端中使用 REST API。推荐通过 Homebrew（macOS）或 Scoop（Windows）安装。

**`Homebrew（macOS）`**

```bash title="Homebrew（macOS）"
brew install elevenlabs/tap/elevenlabs
```

**`Scoop（Windows）`**

```powershell title="Scoop（Windows）"
scoop bucket add elevenlabs https://github.com/elevenlabs/scoop-bucket
scoop install elevenlabs
```

**`npm`**

```bash title="npm"
npm install -g @elevenlabs/cli
```

**`curl`**

```bash title="curl"
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elevenlabs/cli/releases/latest/download/elevenlabs-cli-installer.sh | sh
```

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

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

```bash
elevenlabs auth login
```

## 官方 Agents Platform 库

这些库专为 ElevenLabs [Agents Platform](/docs/zh/eleven-agents/overview) 设计。

| 语言           | 文档                                                     | 包管理器                                                                            |
| ------------ | ------------------------------------------------------ | ------------------------------------------------------------------------------- |
| JavaScript   | [文档](/docs/zh/eleven-agents/libraries/java-script)     | [npm](https://www.npmjs.com/package/@elevenlabs/client)                         |
| React        | [文档](/docs/zh/eleven-agents/libraries/react)           | [npm](https://www.npmjs.com/package/@elevenlabs/react)                          |
| React Native | [文档](/docs/zh/eleven-agents/libraries/react-native)    | [npm](https://www.npmjs.com/package/@elevenlabs/react-native)                   |
| Python       | [文档](/docs/zh/eleven-agents/libraries/python)          | [PyPI](https://pypi.org/project/elevenlabs/)                                    |
| Swift        | [文档](/docs/zh/eleven-agents/libraries/swift)           | [GitHub](https://github.com/elevenlabs/ElevenLabsSwift)                         |
| Kotlin       | [文档](/docs/zh/eleven-agents/libraries/kotlin)          | [Maven](https://central.sonatype.com/artifact/io.elevenlabs/elevenlabs-android) |
| Flutter      | [文档](https://github.com/elevenlabs/elevenlabs-flutter) | [Pub](https://pub.dev/packages/elevenlabs_agents)                               |

## 第三方库

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

| 库             | 文档                                                                         | 包管理器                                                         |
| ------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------ |
| Vercel AI SDK | [文档](/docs/zh/eleven-api/guides/how-to/speech-to-text/batch/vercel-ai-sdk) | [npm](https://www.npmjs.com/package/ai)                      |
| .NET          | [文档](https://github.com/RageAgainstThePixel/ElevenLabs-DotNet)             | [NuGet](https://www.nuget.org/packages/ElevenLabs-DotNet)    |
| Unity         | [文档](https://github.com/RageAgainstThePixel/com.rest.elevenlabs)           | [OpenUPM](https://openupm.com/packages/com.rest.elevenlabs/) |