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

# Controle de velocidade

## Visão geral

O recurso de controle de velocidade permite ajustar a rapidez ou lentidão com que seu agente fala. Isso pode ser útil para:

* Tornar a fala mais acessível para diferentes públicos
* Adequar-se a casos de uso específicos (por exemplo, mais lenta para conteúdo educacional)
* Otimizar para diferentes tipos de conversa

## Configuração

A velocidade é controlada pelo [`parâmetro speed`](/docs/pt/api-reference/agents/create#request.body.conversation_config.tts.speed) com as seguintes especificações:

* **Intervalo**: 0,7 a 1,2
* **Padrão**: 1,0
* **Tipo**: Opcional

### Atualize a velocidade

#### Atualizar pelo dashboard

Abra seu agente no dashboard, acesse a aba **Voz** e ajuste o controle de velocidade. Salve as alterações.

![Configurações de controle de velocidade na aba Voz](/docs/_fern-img/4a1dfe1db33f9f03bb614b56173c7c00596f2d6c36b0f17ce43f151bd4d07f66.webp)

#### Atualizar pela CLI

#### Baixe a configuração do agente

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

#### Edite \`agent_configs/\<agent-name>.json\`

Defina `conversation_config.tts.speed`:

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

#### Envie suas alterações

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

#### Atualizar pela 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 },
  },
});
```

## Como funciona

O parâmetro de velocidade afeta o ritmo da geração de fala:

* Valores abaixo de 1,0 deixam a fala mais lenta
* Valores acima de 1,0 deixam a fala mais rápida
* 1,0 representa a velocidade normal de fala

> **Note**
>
> Valores extremos próximos ao mínimo ou ao máximo podem afetar a qualidade da fala gerada.

## Boas práticas

* Comece com a velocidade padrão (1,0) e ajuste com base no feedback dos usuários
* Teste diferentes velocidades com seu conteúdo específico
* Considere seu público-alvo ao definir a velocidade
* Monitore a qualidade da fala em valores extremos

> **Warning**
>
> Não há suporte para valores fora do intervalo de 0,7 a 1,2.