# Tom e andamento

> Suba ou desça o tom de uma voz ou de uma música em semitons, ou acelere e desacelere o áudio sem mudar o tom. Funciona com áudio e com o som de um vídeo.

Source: https://nodaro.ai/pt-BR/docs/nodes/audio/pitch-tempo

O nó **Tom e andamento** muda o tom e o andamento de um áudio de forma independente. **Tom** sobe ou desce o som em semitons e mantém a duração. **Andamento** deixa o som mais rápido ou mais lento e mantém o tom. Conecte um áudio para receber um áudio de volta, ou um vídeo para receber o mesmo vídeo com o tom do som alterado.

## Quando usar
- Passar uma música ou uma melodia para outra tonalidade.
- Deixar uma voz mais grave ou mais aguda, mantendo a voz natural.
- Desacelerar ou acelerar um clipe para caber em um intervalo de tempo, sem que a voz mude de tom.
- Criar uma voz de esquilo ou de gigante para um personagem.

## Início rápido
### Adicione o nó
Pressione Tab no canvas e escolha **Áudio › Edição de áudio › Tom e andamento**.

### Conecte a mídia
Conecte um nó de áudio ou um nó de vídeo à entrada **Mídia**.

### Defina o tom e o andamento
Abra o painel de configurações. Defina **Tom (semitons)**, **Andamento** ou os dois.

### Execute
Clique em **Executar** no nó. Para um áudio, o resultado aparece na saída **Áudio**. Para um vídeo, ele aparece na saída **Vídeo**.

Workflow: Uma narração fica mais grave e depois é mesclada a um vídeo.

- Texto para fala → Tom e andamento (mídia)
- Tom e andamento → Mesclar vídeo e áudio (áudio)

## Entrada e saída
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Mídia** | Nós de áudio e de vídeo | O áudio, ou o vídeo cujo som você quer mudar. |

A saída acompanha a entrada. Para um áudio, a saída é **Áudio**, um arquivo MP3. Para um vídeo, a saída é **Vídeo**: o mesmo vídeo, com a imagem copiada como está e o tom do som alterado. O áudio termina exatamente quando a imagem termina.

O próprio nó lê o arquivo para decidir se ele é um áudio ou um vídeo. Um arquivo só de áudio é tratado como áudio, mesmo quando chega por uma conexão de vídeo.

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Tom (semitons)** | De -12 a 12, em passos de 0,1. O padrão é 0. 12 é uma oitava acima e -12 é uma oitava abaixo. |
| **Andamento** | De 0,5 a 2, em passos de 0,05. O padrão é 1. 0,5 toca na metade da velocidade e deixa o áudio duas vezes mais longo. 2 toca no dobro da velocidade. O tom não muda. |
| **Preservar formantes** | Ativado por padrão. Mantém uma voz soando como a mesma pessoa quando o tom muda. Desative para uma voz de esquilo ou de gigante. |

Para um vídeo, **Andamento** fica fixo em 1 e a configuração fica desativada, para que o som continue acompanhando a imagem. Para mudar a velocidade de um vídeo, use [Ajustar velocidade](https://nodaro.ai/docs/nodes/video/adjust-speed).

## Créditos
O nó Tom e andamento custa **22 créditos por minuto iniciado da entrada**, de 1 minuto até 30 minutos. Um clipe de 45 segundos é cobrado como 1 minuto, e um clipe de 3 minutos e 10 segundos, como 4 minutos. O nó mostra o preço exato antes de executar.

O preço depende só da duração da entrada. O tom, o andamento e uma saída mais longa depois de desacelerar não mudam o preço. O nó mede a entrada antes de qualquer cobrança, então a mesma entrada sempre custa o mesmo.

## Dicas
- **Fique dentro de cerca de 4 semitons para uma fala natural.** Mudanças maiores deixam a voz com som processado, mesmo com **Preservar formantes** ativado.
- **Mude a tonalidade de uma música pelo intervalo.** Por exemplo, -2 desce a música um tom inteiro.
- **Encaixe um clipe em um intervalo com pequenas mudanças de andamento.** Um andamento de 0,9 deixa um clipe cerca de 11% mais longo, e a voz mantém o tom.
- **Mude o tom de uma voz antes de mesclá-la.** Coloque Tom e andamento antes de [Mesclar vídeo e áudio](https://nodaro.ai/docs/nodes/video/merge-video-audio) ou de [Mixar áudio](https://nodaro.ai/docs/nodes/audio/mix-audio).

## Solução de problemas
| Mensagem | O que fazer |
| --- | --- |
| A entrada tem mais de 30 minutos | Corte a entrada antes com [Cortar áudio](https://nodaro.ai/docs/nodes/audio/trim-audio) e depois execute o nó no clipe mais curto. Nada é cobrado. |
| Não foi possível ler a duração da entrada | Confira se o arquivo abre e se está em um formato comum de áudio ou de vídeo. Nada é cobrado. |
| A mídia não tem faixa de áudio para alterar | O vídeo não tem som. Adicione um som ao vídeo antes, por exemplo com [Mesclar vídeo e áudio](https://nodaro.ai/docs/nodes/video/merge-video-audio). Os créditos são reembolsados. |

## Pela API
`POST /v1/pitch-tempo` recebe exatamente um entre `audioUrl` e `videoUrl`, além dos opcionais `semitones`, `tempo` e `preserveFormants`. O método do SDK é `client.audio.pitchTempo`, o comando da CLI é `nodaro audio pitch-tempo` e a ferramenta MCP é `pitch_tempo`. Veja [Voz e mídia](https://nodaro.ai/docs/developers/api/voice-and-media).

## Perguntas frequentes

### Como mudo o tom de uma voz sem mudar a velocidade?

Defina “Tom (semitons)” e deixe “Andamento” em 1. O áudio mantém a duração. Deixe “Preservar formantes” ativado para que a voz continue soando como a mesma pessoa.

### Posso desacelerar um áudio sem que ele soe mais grave?

Sim. Defina “Andamento” abaixo de 1, por exemplo 0,8. O áudio fica mais longo e o tom continua o mesmo.

### O nó “Tom e andamento” funciona com vídeo?

Sim, para o tom. O nó altera o tom do som do vídeo e retorna o mesmo vídeo, com a imagem intacta. O andamento fica em 1 para um vídeo, para que o som continue acompanhando a imagem.

### Quantos créditos custa o nó “Tom e andamento”?

22 créditos por minuto iniciado da entrada, de 1 a 30 minutos. O preço depende só da duração da entrada, não das configurações.

### Como faço uma voz de esquilo ou de gigante?

Desative “Preservar formantes” e depois suba o tom para uma voz de esquilo ou desça o tom para uma voz de gigante.