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

# Biblioteca de vozes, prévias e vozes personalizadas

> Pesquise e ouça prévias de vozes do ThunderPhone, gere amostras faladas, solicite acesso a vozes personalizadas, crie uma voz a partir de áudio e gerencie preços e status de vozes.

Abra **Vozes** (`/dashboard/voices`) para explorar vozes para seus agentes e,
quando habilitado para sua organização, criar vozes personalizadas a partir de uma curta amostra de áudio.

## Navegue pela biblioteca de vozes

Use a busca e os filtros **Idioma** e **Gênero** para restringir o catálogo.
Cada linha mostra o nome da voz, informações sobre os idiomas compatíveis, uma amostra de áudio integrada e qualquer sobretaxa premium aplicável a todos ou alguns idiomas.

O construtor de agentes filtra esse mesmo catálogo para vozes compatíveis com os
idiomas principal e adicionais do agente. Selecionar uma voz na biblioteca não
altera um agente; abra a aba **Configuração** do agente para atribuí-la.

## Ouça uma voz dizer seu texto

Escolha **Ouvir *voz* dizer suas palavras**, insira **1–500 caracteres**, selecione um
idioma compatível e gere uma amostra.

* Cada nova amostra custa **3¢** do saldo da organização.
* A caixa de diálogo de confirmação mostra a cobrança antes da geração.
* Uma amostra idêntica em cache é fornecida sem custo e marcada como **Fornecida do cache**.
* Cada organização pode criar até **30 amostras por hora**.
* Uma voz só pode ser pré-visualizada em idiomas disponíveis para essa voz.

A [API de amostras de voz](/api-reference/voice-samples) expõe o mesmo fluxo
programaticamente.

## Solicite acesso a vozes personalizadas

As vozes personalizadas são habilitadas por organização. Se o acesso não estiver habilitado, escolha
**Solicitar acesso**, insira o número de slots de voz necessários e, opcionalmente,
descreva o caso de uso em até **2.000 caracteres**.

Apenas uma solicitação pode estar pendente por vez. Depois que o acesso é habilitado, a página
mostra o número de slots de voz personalizada usados e disponíveis. Use **Solicitar mais
slots** quando precisar de uma cota maior.

## Crie uma voz personalizada

<Steps>
  <Step title="Confirme seus direitos">
    Confirme que você tem os direitos de usar e clonar a voz. Uma voz personalizada
    não pode ser criada sem essa confirmação.
  </Step>

  <Step title="Grave ou envie uma amostra limpa">
    Grave até 15 segundos no navegador ou envie um arquivo **WAV** ou **MP3**
    de até **4 MB**. Use uma única pessoa falando, um ritmo constante e o mínimo possível de
    ruído de fundo.
  </Step>

  <Step title="Dê um nome e classifique-a">
    Insira um nome de 1–100 caracteres, escolha o idioma e, opcionalmente, marque
    a voz como feminina ou masculina. Selecione **Criar voz**.
  </Step>
</Steps>

A criação é assíncrona. Uma voz passa por **Em criação**, **Pronta** ou
**Falhou**. Vozes prontas podem ser reproduzidas e atribuídas a agentes; uma voz com falha
pode ser tentada novamente com uma nova amostra.

<Note>
  O seletor de idioma de voz personalizada contém os idiomas compatíveis com a criação de
  vozes personalizadas. Ele pode ser mais restrito que o
  [catálogo completo de idiomas para agentes de voz](/pt/guides/supported-languages).
</Note>

## Renomeie, tente novamente e exclua

* **Renomear** altera o rótulo exibido em todo o painel sem alterar
  o ID da voz.
* **Tentar novamente** inicia uma nova tentativa de criação após uma falha.
* **Excluir** remove a voz do seletor da sua organização e libera seu
  slot de cota. Os agentes que já a utilizam mantêm a configuração salva até que você
  os salve novamente com outra voz.

Para os contratos completos de objeto, status, solicitação de cota, prévia, renomeação e exclusão,
consulte a [API de vozes personalizadas](/api-reference/custom-voices).

## Preços

As combinações estáticas de voz/idioma premium são marcadas como **+3¢/min** na biblioteca e
no construtor. A sobretaxa efetiva de fala se baseia na combinação real de voz e idioma;
os rótulos de idioma e de voz premium não se acumulam em duas cobranças separadas de
3¢. Os preços de voz personalizada específicos da organização, quando aplicáveis, são
retornados pela política de voz personalizada e refletidos na taxa total do construtor.