> ## 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

> Configura un paso del flujo de trabajo que convierte texto en voz con ElevenLabs y devuelve activos de audio subidos para pasos posteriores

# ElevenLabs

Usa **ElevenLabs** cuando quieras que un paso del flujo de trabajo convierta texto en audio hablado y reutilice el archivo generado más adelante en el flujo de trabajo.

El paso llama directamente a **ElevenLabs**. Conecta una clave API de ElevenLabs en **Integrations** del workspace para facturación **Personal**, o usa facturación **Hosted** con la clave de plataforma de Fetch Hive.

## Configuración

| Opción              | Requerido | Descripción                                                                                                                                                  |
| ------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Name                | No        | Etiqueta del paso en el lienzo del flujo de trabajo.                                                                                                         |
| Text                | Sí        | El texto ingresado en **Text**. Admite variables del flujo de trabajo. Máximo 5.000 caracteres por ejecución.                                                |
| Voice               | Sí        | Voz de ElevenLabs desde el selector de la biblioteca de voces. Busca en la biblioteca o elige entre voces destacadas. Se guarda internamente como ID de voz. |
| Model               | No        | ID de modelo de ElevenLabs. Predeterminado: `eleven_multilingual_v2`.                                                                                        |
| Output Format       | No        | Formato de audio de ElevenLabs. Predeterminado: `mp3_44100_128`.                                                                                             |
| Voice settings      | No        | Valores opcionales de stability, similarity boost, style, speed y speaker boost.                                                                             |
| Charge Type         | No        | Indica si el paso usa facturación **Hosted** o **Personal**.                                                                                                 |
| When the step fails | No        | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla.                                                               |

Usa el botón **Insert Variable** junto a **Text** cuando el contenido hablado deba provenir de entradas del flujo de trabajo o de pasos anteriores.

Este paso usa las pestañas **Settings** y **Output**. La pestaña **Output** muestra el activo de audio generado después de una ejecución de prueba exitosa.

## Salida

Este paso devuelve un objeto con:

* `settings`: la voz, el modelo, el formato de salida, los ajustes de voz y el modo de facturación usados en la llamada
* `assets`: una matriz con un registro de activo de audio subido

Cada elemento de activo incluye:

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

Para pasar el objeto completo hacia adelante:

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

Para referenciar directamente la URL del audio generado:

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

## Coste

La facturación sigue el mismo patrón que los pasos de LLM alojado y generación de imágenes:

| Tipo de cargo | Clave API                                                | Facturación en Fetch Hive                                                                                       |
| ------------- | -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Personal**  | Tu integración de ElevenLabs en el workspace             | **1 crédito de tarea** por ejecución. ElevenLabs factura directamente tu clave API según los caracteres usados. |
| **Hosted**    | Clave de plataforma de Fetch Hive (`ELEVENLABS_API_KEY`) | **Monedero LLM alojado** (coste por caracteres) más **1 crédito de tarea** por ejecución.                       |

Tarifas del proveedor por caracteres (según [precios API de ElevenLabs](https://elevenlabs.io/pricing/api)):

* Modelos **Flash / Turbo** (`eleven_turbo_v2_5`, `eleven_flash_v2_5`): **\$0.05 por 1.000 caracteres**
* Modelos **Multilingual v2/v3** (`eleven_multilingual_v2`, `eleven_monolingual_v1`): **\$0.10 por 1.000 caracteres**

Fetch Hive lee el recuento facturado del encabezado de respuesta `character-cost` de ElevenLabs cuando está disponible; si no, usa la longitud del texto de entrada resuelto.

Las ejecuciones hosted requieren saldo positivo en el monedero LLM alojado. Si el monedero está vacío, la API devuelve `402` con `insufficient_hosted_llm_credits`.

## Notas

* El modo personal requiere una integración de ElevenLabs habilitada con una clave API válida en el workspace.
* El modo hosted requiere que Fetch Hive tenga configurada `ELEVENLABS_API_KEY`.
* El audio generado se almacena como activo del workspace en Fetch Hive.

Véase también: [Creating and Editing](../../creating-and-editing) y [Integrations](../../../workspace/integrations)