✨ Visão Geral

Este nó da comunidade para o n8n simplifica o processamento de áudio gerado pela API Google Gemini Text-to-Speech (TTS).

Ele pega o dado de áudio "cru" (em formato PCM codificado em Base64) retornado pela API, decodifica-o e o converte para um arquivo .mp3 padrão utilizando FFmpeg. Isso torna o áudio imediatamente utilizável em qualquer etapa do seu workflow, seja para enviar em apps de mensagem, armazenar em um banco de dados ou disponibilizar para download.

Principais Funcionalidades

Decodificação Automática: Extrai o áudio Base64 do JSON da API Gemini sem esforço.

Conversão para MP3: Converte o áudio PCM para o formato universal MP3.

Fácil Integração: Encaixa-se perfeitamente após o seu nó de HTTP Request que chama a API.

Configuração Simples: Apenas duas propriedades para configurar, com valores padrão inteligentes.

⚠️ Pré-requisitos

CRÍTICO: Você obrigatoriamente precisa ter o FFmpeg instalado e acessível no ambiente onde sua instância do n8n está rodando. O nó executa o comando ffmpeg diretamente no sistema.

Instalação com Docker: Você precisará criar uma imagem Docker personalizada baseada na imagem oficial do n8n e adicionar um passo para instalar o FFmpeg. Exemplo no Dockerfile:

FROM n8nio/n8n USER root RUN apt-get update && apt-get install -y ffmpeg USER node

Instalação em Servidor (Debian/Ubuntu): Instale o FFmpeg com o gerenciador de pacotes do seu sistema:

sudo apt-get update && sudo apt-get install ffmpeg

📦 Instalação

Na sua instância do n8n, vá para Settings > Community Nodes.

Clique em Install a community node.

Digite o nome do pacote no npm: @n8n-community/n8n-nodes-gemini-audio-converter

Clique em Install. O n8n irá instalar o nó e recarregar a interface.

⚙️ Como Usar (Quick Start)

O fluxo de trabalho é simples:

[HTTP Request para Gemini] -> [Gemini Audio Converter] -> [Próximo Nó]

Adicione o nó: Coloque o nó "Gemini Audio Converter" logo após o nó que recebe a resposta da API Gemini TTS (geralmente um HTTP Request).

Verifique o caminho: O nó já vem configurado com o caminho padrão candidates[0].content.parts[0].inlineData.data para encontrar o áudio. Altere apenas se a estrutura da sua resposta for diferente.

Use o resultado: O arquivo MP3 convertido será adicionado como um dado binário ao item. O nome padrão da propriedade é data.

Conecte o próximo nó: Agora você pode usar este dado binário no nó seguinte. Por exemplo, para enviar o arquivo em um novo HTTP Request, referencie-o na aba Body > Binary Data.

🔧 Propriedades do Nó

Propriedade

Descrição

Valor Padrão

Input Base64 Data Field

O "caminho" (JSON path) para o campo que contém a string de áudio codificada em Base64.

candidates[0].content.parts[0].inlineData.data

Output Property Name

O nome da nova propriedade binária que conterá o arquivo MP3 final. Use este nome no próximo nó.

data

📄 Licença

Distribuído sob a licença MIT. Veja LICENSE para mais informações.