> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ElevenLabs

> 配置使用 ElevenLabs 将文本转换为语音并返回已上传音频资产记录的工作流步骤，供后续步骤使用

# ElevenLabs

当你希望工作流步骤将文本转换为语音音频，并在后续步骤中复用生成的文件时，请使用 **ElevenLabs**。

该步骤直接调用 **ElevenLabs**。在工作区 **Integrations** 中连接 ElevenLabs API 密钥以使用 **Personal** 计费，或使用 Fetch Hive 平台密钥的 **Hosted** 计费。

## 配置

| 选项                  | 必填 | 说明                                                            |
| ------------------- | -- | ------------------------------------------------------------- |
| Name                | 否  | 工作流画布中的步骤标签。                                                  |
| Text                | 是  | 在 **Text** 中输入的文本。支持工作流变量。每次运行最多 5,000 个字符。                   |
| Voice               | 是  | 通过语音库选择器选择 ElevenLabs 语音。可搜索语音库或从精选语音中选择。内部仍保存为语音 ID。         |
| Model               | 否  | ElevenLabs 模型 ID。默认：`eleven_multilingual_v2`。                 |
| Output Format       | 否  | ElevenLabs 音频格式。默认：`mp3_44100_128`。                           |
| Voice settings      | 否  | 可选的 stability、similarity boost、style、speed 和 speaker boost 值。 |
| Charge Type         | 否  | 步骤使用 **Hosted** 还是 **Personal** 计费。                           |
| When the step fails | 否  | 控制此步骤失败时工作流应 **Terminate Workflow** 还是 **Continue**。          |

当口播内容应来自工作流输入或先前步骤时，请使用 **Text** 旁的 **Insert Variable** 按钮。

此步骤使用 **Settings** 和 **Output** 选项卡。成功测试运行后，**Output** 选项卡会显示生成的音频资产。

## 输出

此步骤输出一个对象，包含：

* `settings`：所选语音、模型、输出格式、语音设置和计费模式
* `assets`：包含一个已上传音频资产记录的数组

每个资产项包括：

* `id`
* `file_url`
* `file_name`
* `file_size`
* `file_type`

传递完整输出对象：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

直接引用生成的音频 URL：

```text theme={null}
{{step_2.output.assets.0.file_url}}
{{step_2.output.assets.0.file_name}}
```

## 费用

计费方式与托管 LLM 和图像生成步骤相同：

| 计费类型         | API 密钥                                | Fetch Hive 计费                                         |
| ------------ | ------------------------------------- | ----------------------------------------------------- |
| **Personal** | 工作区 ElevenLabs 集成                     | 每次运行 **1 个平台任务积分**。ElevenLabs 根据使用的字符数直接向你的 API 密钥计费。 |
| **Hosted**   | Fetch Hive 平台密钥（`ELEVENLABS_API_KEY`） | **托管 LLM 钱包**（按字符计费）外加每次运行 **1 个平台任务积分**。             |

按字符计费的提供商费率（见 [ElevenLabs API 定价](https://elevenlabs.io/pricing/api)）：

* **Flash / Turbo** 模型（`eleven_turbo_v2_5`、`eleven_flash_v2_5`）：**每 1,000 字符 \$0.05**
* **Multilingual v2/v3** 模型（`eleven_multilingual_v2`、`eleven_monolingual_v1`）：**每 1,000 字符 \$0.10**

Fetch Hive 在可用时从 ElevenLabs 响应头 `character-cost` 读取计费字符数，否则回退到解析后的输入文本长度。

Hosted 运行需要托管 LLM 钱包余额大于零。若钱包为空，API 返回 `402` 及 `insufficient_hosted_llm_credits`。

## 说明

* Personal 模式需要工作区启用 ElevenLabs 集成并配置有效 API 密钥。
* Hosted 模式需要 Fetch Hive 配置 `ELEVENLABS_API_KEY`。
* 生成的音频会作为工作区资产存储在 Fetch Hive 中。

另请参阅：[Creating and Editing](../../creating-and-editing) 和 [Integrations](../../../workspace/integrations)