---
title: "Usa ElevenLabs in OpenClaw tramite RunAPI — Guida API TTS e Audio"
url: "https://runapi.ai/it/openclaw-elevenlabs.md"
canonical: "https://runapi.ai/it/openclaw-elevenlabs"
locale: "it"
model: "elevenlabs"
---

# Usa ElevenLabs in OpenClaw.

ElevenLabs fornisce sei endpoint audio tramite RunAPI — sintesi vocale turbo-v2.5 con latenza inferiore al secondo, multilingual-v2 per 29 lingue, dialogue-v3 per conversazioni multi-speaker, effetti sonori, trascrizione speech-to-text e isolamento vocale. Gli agenti OpenClaw li chiamano tutti con la stessa API key RunAPI usata per la chat.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/elevenlabs/text_to_speech \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-to-speech-turbo-v2.5",
    "text": "Welcome to RunAPI. This audio was generated by ElevenLabs turbo v2.5.",
    "speed": 1.0,
    "stability": 0.5,
    "similarity_boost": 0.75
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "text-to-speech-turbo-v2.5"
}

```

## How it works

1. **Configura RunAPI** — Imposta RUNAPI_API_KEY nel tuo ambiente. Se hai già configurato RunAPI per la chat in OpenClaw, la stessa key funziona per tutti gli endpoint ElevenLabs — sintesi vocale, STT, dialogue, effetti sonori e isolamento vocale.
2. **Chiama text_to_speech** — Invia una POST all'endpoint text_to_speech con model impostato su text-to-speech-turbo-v2.5, il testo da pronunciare e i parametri facoltativi voice, speed e stability. Per output multilingue, usa text-to-speech-multilingual-v2 con un voice e language_code.
3. **Ottieni il risultato** — L'endpoint restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed, poi leggi l'URL audio di output dalla risposta.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. text-to-speech-turbo-v2.5 (bassa latenza) o text-to-speech-multilingual-v2 (29 lingue). |
| `text` | `string` | Obbligatorio. Il testo da convertire in audio. Max 5000 caratteri. |
| `voice` | `string` | Voice ID ElevenLabs. Obbligatorio per multilingual-v2. turbo-v2.5 usa una voce predefinita se omesso. |
| `speed` | `float` | Facoltativo. Moltiplicatore di velocità di riproduzione. Range da 0.7 a 1.2. |
| `stability` | `float` | Facoltativo. Consistenza vocale. Range da 0.0 a 1.0. Valori più bassi aggiungono espressività. |
| `similarity_boost` | `float` | Facoltativo. Applicazione della somiglianza vocale. Range da 0.0 a 1.0. |
| `style` | `float` | Facoltativo. Esagerazione dello stile. Range da 0.0 a 1.0. |
| `language_code` | `string` | Facoltativo. Lingua target per multilingual-v2, ad es. en, es, ja. |
| `callback_url` | `string` | Facoltativo. URL webhook che riceve una POST quando il task è completato. |

## FAQ

### Quali endpoint ElevenLabs posso usare da OpenClaw?

RunAPI espone sei endpoint ElevenLabs: text_to_speech (turbo-v2.5 e multilingual-v2), text_to_dialogue (dialogue-v3 per multi-speaker), text_to_sound (effetti sonori), speech_to_text (trascrizione)e isolate_audio (estrazione vocale). Tutti condividono la stessa RUNAPI_API_KEY.

### Qual è la differenza tra turbo-v2.5 e multilingual-v2?

turbo-v2.5 è ottimizzato per bassa latenza e output principalmente in inglese — applica una voce predefinita quando non ne viene specificata una. multilingual-v2 supporta 29 lingue e richiede un voice ID esplicito e un language_code facoltativo. Turbo costa circa la metà per carattere.

### La sintesi vocale ElevenLabs è sincrona o asincrona su RunAPI?

Asincrono. L'endpoint di creazione restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task o fornisci un callback_url per ricevere un webhook quando il file audio è pronto per il download.

### Come viene fatturato ElevenLabs su RunAPI?

Gli endpoint text-to-speech e dialogue sono fatturati per carattere di testo di input. speech-to-text è fatturato per minuto di audio. L'isolamento audio è fatturato per task. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate.

### Posso usare ElevenLabs dialogue-v3 per audio multi-speaker in OpenClaw?

Sì. Chiama l'endpoint text_to_dialogue con model text-to-dialogue-v3. Passa un array dialogue in cui ogni elemento ha un text e un voice ID. Il testo totale di tutti i parlanti deve essere inferiore a 5000 caratteri.


## Links

- [Guida di configurazione di OpenClaw →](https://runapi.ai/it/openclaw)
- [ElevenLabs su RunAPI →](https://runapi.ai/it/models/elevenlabs)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)