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

# Controllo della velocità

## Panoramica

La funzione di controllo della velocità ti permette di regolare la velocità con cui parla il tuo agente. Può essere utile per:

* Rendere il parlato più accessibile a pubblici diversi
* Adattarsi a casi d'uso specifici, ad esempio una velocità più bassa per contenuti educativi
* Ottimizzare le conversazioni di diverso tipo

## Configurazione

La velocità è controllata tramite il [parametro `speed`](/docs/it/api-reference/agents/create#request.body.conversation_config.tts.speed) con le seguenti specifiche:

* **Intervallo**: da 0.7 a 1.2
* **Predefinito**: 1.0
* **Tipo**: facoltativo

### Aggiorna la velocità

#### Aggiorna dalla dashboard

Apri il tuo agente nella dashboard, vai alla scheda **Voce** e regola il controllo della velocità. Salva le modifiche.

![Impostazioni del controllo della velocità nella scheda Voce](/docs/_fern-img/4a1dfe1db33f9f03bb614b56173c7c00596f2d6c36b0f17ce43f151bd4d07f66.webp)

#### Aggiorna tramite la CLI

#### Recupera la configurazione dell'agente

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### Modifica \`agent\_configs/\<agent-name>.json\`

Imposta `conversation_config.tts.speed`:

```json
{
  "conversation_config": {
    "tts": {
      "speed": 1.1
    }
  }
}
```

#### Invia le modifiche

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### Aggiorna tramite l'API

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    conversation_config={
        "tts": {"speed": 1.1},
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  conversationConfig: {
    tts: { speed: 1.1 },
  },
});
```

## Come funziona

Il parametro speed influisce sul ritmo di generazione del parlato:

* I valori inferiori a 1.0 rallentano il parlato
* I valori superiori a 1.0 accelerano il parlato
* 1.0 rappresenta una velocità di parlato normale

> **Note**
>
> I valori estremi prossimi al minimo o al massimo possono influire sulla qualità del parlato generato.

## Buone pratiche

* Inizia dalla velocità predefinita (1.0) e regolala in base al feedback degli utenti
* Testa velocità diverse con i tuoi contenuti specifici
* Considera il tuo pubblico di riferimento quando imposti la velocità
* Monitora la qualità del parlato con valori estremi

> **Warning**
>
> I valori al di fuori dell'intervallo 0.7-1.2 non sono supportati.