# Substituir áudio

> Dê uma nova música a um vídeo e mantenha o que as pessoas dizem nele, ou substitua todo o som. A música vem de um arquivo ou é criada a partir de um prompt.

Source: https://nodaro.ai/pt-BR/docs/nodes/video/replace-audio

O nó **Substituir áudio** dá uma nova trilha sonora a um vídeo sem perder o que as pessoas dizem nele. Ele separa a fala de todo o resto do som do vídeo, coloca a nova música por baixo dela e aplica a mixagem ao vídeo no lugar do som original. A música abaixa enquanto alguém fala e volta a subir nas pausas.

A nova música é um arquivo que você conecta ou uma faixa criada para você a partir de um prompt. Tudo roda como uma só tarefa, com um só preço e um só reembolso: se qualquer etapa falhar, a execução inteira é reembolsada.

O Substituir áudio roda só no Nodaro Cloud. Em uma instalação auto-hospedada, o nó não é oferecido, e um workflow que tem um não consegue executá-lo.

## Quando usar
- Colocar uma nova música por baixo de um clipe de alguém falando para a câmera, de uma entrevista ou de um tutorial sem perder a voz.
- Trocar uma trilha sonora indesejada ou protegida por direitos autorais por uma licenciada ou gerada, e manter o diálogo.
- Dar a mesma música de fundo a uma série de clipes.
- Criar uma versão de um anúncio com outro clima, a partir de um prompt de música.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Vídeo › Som para vídeo › Substituir áudio**.

### Conectar o vídeo
Conecte à entrada **Vídeo** o vídeo cujo som você quer substituir.

### Escolher a música
Para usar um arquivo, conecte à entrada **Música** um áudio, ou um vídeo cujo som é usado. Para criar a música, defina **Música** como **Criar a partir de um prompt** no painel de configurações e descreva-a em **Prompt da música**.

### Executar
Clique em **Executar** no nó. O vídeo com o novo som aparece no nó.

Workflow: Uma entrevista mantém a voz, e uma faixa licenciada substitui a música dela.

- Enviar vídeo → Substituir áudio (vídeo)
- Enviar áudio → Substituir áudio (música)

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Vídeo** | Nós de vídeo | O vídeo cujo som é substituído. Obrigatória. |
| **Música** | Nós de áudio e de vídeo | A nova música: um áudio, ou um vídeo cujo som é usado. Conecte uma fonte. Deixe vazia quando a música é criada a partir de um prompt. |

## Saídas
A saída, **Vídeo**, é o vídeo com o novo som. Ela tem exatamente a duração do vídeo: uma música mais curta termina em silêncio, e uma música mais longa é cortada.

A execução também guarda três faixas próprias, mostradas abaixo do nó e na tarefa: a **Mixagem** final, a nova **Música** e a **Fala** separada, quando ela foi mantida.

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Modo** | **Manter a fala**, o padrão, mantém a fala e substitui a música. **Substituir todo o som** faz da nova música o único som do vídeo, fala incluída. |
| **Música** | De onde vem a nova música: **Música conectada**, o padrão, ou **Criar a partir de um prompt**. |
| **Prompt da música** | A música a criar, descrita em palavras, com até 1.000 caracteres. Por exemplo: “piano lo-fi acolhedor, lento, suave”. Só com **Criar a partir de um prompt**. O resultado é instrumental e tem a duração do vídeo. |
| **Volume da música** | O volume da nova música, de 0% a 200%. O padrão é 80%. |
| **Volume da fala** | O volume da fala mantida, de 0% a 200%. O padrão é 100%. |
| **Redução sob a fala** | Quanto a música abaixa enquanto alguém fala, de 0 a 100. O padrão é 70. Em 0, a música fica no mesmo nível. Só no modo **Manter a fala**. |

## Limites
- Vídeos de até 10 minutos, e de até 6 minutos quando a música é criada a partir de um prompt.
- Arquivos de até 500 MB.
- Um arquivo que não pode ser lido, um vídeo sem imagem ou uma música sem som é recusado antes de qualquer cobrança.

## Créditos
O Substituir áudio custa um preço por execução, definido pelo modo e pela origem da música. A duração do vídeo não altera o preço.

- **Manter a fala** custa mais que **Substituir todo o som**, porque primeiro separa a fala.
- **Uma música criada a partir de um prompt** custa mais que um arquivo de música, porque a música é criada na execução.
- Uma execução é cobrada pelo que faz. **Manter a fala** em um vídeo sem som não tem fala para manter, então roda, e é cobrado, como **Substituir todo o som**.
- Se qualquer etapa falhar, a execução inteira é reembolsada.

O nó mostra o preço por execução no painel de configurações e no botão **Executar**.

## Dicas
- **Mantenha a fala para vozes.** Use **Manter a fala** em clipes de alguém falando para a câmera, entrevistas, tutoriais e anúncios com narração. A voz continua clara sobre a nova música.
- **Substitua tudo em clipes só com música.** Use **Substituir todo o som** quando nada do som original deve ficar, por exemplo em um clipe cujo som é só música ou ruído.
- **Ajuste a redução.** Aumente **Redução sob a fala** quando a música compete com a voz. Diminua para uma música de fundo que deve continuar presente.
- **Uma música longa não é problema.** Um arquivo de música mais longo que o vídeo é cortado onde o vídeo termina.
- **Para várias faixas, use o Mesclar vídeo e áudio.** Para adicionar uma narração, música e efeitos com tempos de início próprios, use o [**Mesclar vídeo e áudio**](https://nodaro.ai/docs/nodes/video/merge-video-audio).

## Pela API
`POST /v1/replace-audio` recebe `videoUrl` e exatamente uma fonte de música, `musicUrl` ou `musicPrompt`, mais os campos opcionais `mode` (`keep-speech` ou `replace-all`), `musicVolume`, `speechVolume` e `duckAmount`. Ele responde `{ jobId }`; consulte `GET /v1/jobs/:jobId` periodicamente. Um cabeçalho `Idempotency-Key` faz uma nova tentativa responder com a tarefa que já começou. Um arquivo acima de um limite é um `413`, e um arquivo que não pode ser lido é um `422`, os dois antes de qualquer cobrança.

O método do SDK é `client.media.replaceAudio`, e a ferramenta MCP é `replace_audio`. Veja [Voz e mídia](https://nodaro.ai/docs/developers/api/voice-and-media).

## Perguntas frequentes

### O que o “Substituir áudio” faz?

O “Substituir áudio” dá uma nova trilha sonora a um vídeo. No modo “Manter a fala”, ele separa a fala do resto do som, coloca a nova música por baixo dela e abaixa a música enquanto alguém fala. No modo “Substituir todo o som”, a nova música é o único som.

### De onde vem a nova música?

De um arquivo que você conecta à entrada “Música”, um áudio ou um vídeo cujo som é usado, ou de uma faixa criada para você a partir de um prompt. Uma faixa criada a partir de um prompt é instrumental e tem a duração do vídeo.

### Qual é a duração do resultado?

O resultado tem exatamente a duração do vídeo. Uma música mais curta que o vídeo termina em silêncio, e uma música mais longa é cortada onde o vídeo termina.

### Quantos créditos o “Substituir áudio” custa?

Um preço por execução, definido pelo modo e pela origem da música. A duração do vídeo não o altera. “Manter a fala” custa mais que “Substituir todo o som”, e uma música criada a partir de um prompt custa mais que um arquivo. O botão “Executar” mostra o preço.

### Posso usar o “Substituir áudio” em uma instalação auto-hospedada?

Não. O “Substituir áudio” roda só no Nodaro Cloud. Em uma instalação auto-hospedada, o nó não é oferecido, e um workflow que tem um não consegue executá-lo.
