n8n-nodes-nvidia-chat-model

n8n community node — Multi-provider Chat Model para avaliação e comparação de modelos de IA: NVIDIA NIM, Google Gemini e Anthropic Claude

Propósito

Este node foi desenvolvido para teste e avaliação de performance de modelos de IA diretamente no n8n. Ele permite comparar facilmente diferentes provedores e modelos em workflows reais, com rastreamento detalhado de tokens por execução.

Sobre a API NVIDIA NIM: A NVIDIA oferece uma camada gratuita para avaliação em build.nvidia.com, com créditos iniciais para testar os modelos. Este tier é destinado a avaliação e desenvolvimento, não para uso em produção. Para produção, utilize sua própria instância NIM ou verifique os planos pagos da NVIDIA.

Descrição

Este pacote contém um Chat Model custom node para o n8n que integra com múltiplos provedores de IA: NVIDIA NIM, Google Gemini e Anthropic Claude.

É um sub-node que fornece modelos de linguagem para os nodes AI Agent, AI Chain e outros da plataforma n8n.

Funcionalidades

• Multi-provider: suporte a NVIDIA NIM, Google Gemini e Anthropic Claude em um único node
• Lista de modelos dinâmica: os modelos disponíveis são carregados automaticamente a partir da API do provedor configurado
• Troca de provider on-the-fly: ao trocar o provider, a lista de modelos é re-carregada automaticamente
• Parâmetros por provider: cada provedor expõe apenas os parâmetros que suporta (ex: Anthropic não tem frequencyPenalty)
• Rastreamento por execução: cada chamada registra no painel AI do n8n o nome do modelo usado, tokens do prompt, tokens da resposta e total de tokens
• Custom Model: opção para informar qualquer model ID manualmente

O que é rastreado por execução

No painel AI do n8n, cada execução exibe:

| Campo | Descrição | |-------|-----------| | model | Nome do modelo utilizado | | promptTokens | Tokens enviados no prompt | | completionTokens | Tokens gerados na resposta | | totalTokens | Total de tokens consumidos |

Quando a API não retorna o uso real de tokens (ex: alguns modelos NVIDIA), o node exibe uma estimativa (tokenUsageEstimate) calculada a partir da contagem de caracteres.

Provedores Suportados

NVIDIA NIM

API compatível com OpenAI. Inclui modelos como Llama, DeepSeek, Mixtral, Nemotron, Qwen e qualquer modelo do catálogo NVIDIA.

Credencial: NVIDIA NIM API (API Key + Base URL)

| Parâmetro | Range | Padrão | |-----------|-------|--------| | Temperature | 0 – 2 | 0.7 | | Max Tokens | -1 – 128000 | 4096 | | Top P | 0 – 1 | 1 | | Frequency Penalty | -2 – 2 | 0 | | Presence Penalty | -2 – 2 | 0 | | Timeout (ms) | 0+ | 60000 |

Google Gemini

Modelos Google Generative AI (Gemini 1.5, 2.0 Flash, Pro, Ultra, etc.).

Credencial: Google Gemini API (API Key do Google AI Studio)

| Parâmetro | Range | Padrão | |-----------|-------|--------| | Temperature | 0 – 2 | 0.7 | | Max Output Tokens | 1 – 65536 | 2048 | | Top P | 0 – 1 | 0.95 | | Top K | 1 – 100 | 40 | | Timeout (ms) | 0+ | 60000 |

Anthropic Claude

Modelos Claude (Haiku, Sonnet, Opus).

Credencial: Anthropic API (API Key do console.anthropic.com)

| Parâmetro | Range | Padrão | |-----------|-------|--------| | Temperature | 0 – 1 | 0.7 | | Max Tokens | 1 – 32768 | 4096 | | Top P | 0 – 1 | 1 | | Top K | 1 – 500 | 5 |

Instalação

Via npm (recomendado)

npm install n8n-nodes-nvidia-chat-model

Ou instale diretamente pelo painel do n8n em Settings → Community Nodes.

Instalação Manual (Desenvolvimento)

1. Clone ou baixe o repositório
2. Instale as dependências:

npm install

3. Compile o projeto:

npm run build

4. Linke ao n8n:

npm link
cd ~/.n8n
npm link n8n-nodes-nvidia-chat-model

5. Reinicie o n8n:

n8n start

Configuração de Credenciais

NVIDIA NIM

1. Acesse NVIDIA Build
2. Crie uma conta ou faça login
3. Gere uma API Key em Settings → API Keys
4. No n8n, crie uma credencial do tipo NVIDIA NIM API:
   • API Key: sua chave de API
   • Base URL: https://integrate.api.nvidia.com/v1 (padrão)

Google Gemini

1. Acesse Google AI Studio
2. Clique em Create API Key
3. No n8n, crie uma credencial do tipo Google Gemini API:
   • API Key: sua chave do Google AI Studio

Anthropic Claude

1. Acesse Anthropic Console
2. Vá em API Keys e crie uma nova chave
3. No n8n, crie uma credencial do tipo Anthropic API:
   • API Key: sua chave da Anthropic

Nota: A assinatura do Claude.ai (plano pessoal/team) é separada da API Anthropic. Para usar via API é necessário uma API Key de console.anthropic.com.

Como Usar

No Workflow do n8n

1. Adicione um node AI Agent ou AI Chain ao seu workflow
2. Adicione o node AI Chat Model
3. Conecte a saída do AI Chat Model na porta Model do AI Agent/Chain
4. No node, selecione o Provider desejado
5. Configure as credenciais do provider escolhido
6. A lista de modelos será carregada automaticamente
7. Selecione o modelo e ajuste os parâmetros opcionais

Exemplo de Uso

[Trigger] → [AI Agent] → [Resposta]
              ↑
              │
    [AI Chat Model]
    (Provider: Google Gemini)
    (Model: gemini-2.0-flash)

Parâmetros do Node

Provider

Selecione o provedor de IA: NVIDIA NIM, Google Gemini ou Anthropic Claude.

Model

Lista de modelos carregada automaticamente a partir da API do provider configurado. Atualiza ao trocar o provider.

Custom Model ID

Informe manualmente o ID de qualquer modelo. Útil para modelos recém-lançados que ainda não aparecem na lista.

• NVIDIA: use o ID do catálogo, ex: meta/llama-3.1-8b-instruct
• Google: sem o prefixo models/, ex: gemini-2.0-flash
• Anthropic: ID completo, ex: claude-3-5-sonnet-20241022

Options

Parâmetros avançados específicos por provider (veja tabelas acima).

Requisitos

• n8n: versão 1.30.0 ou superior (recomendado para suporte a Anthropic e Google Gemini)
• Node.js: 18.x ou superior

Dependências de Peer

{
  "n8n-workflow": "*",
  "@langchain/openai": ">=0.1.0",
  "@langchain/core": ">=0.1.0",
  "@langchain/google-genai": ">=0.1.0",
  "@langchain/anthropic": ">=0.3.0"
}

Scripts Disponíveis

# Build do projeto
npm run build

# Modo de desenvolvimento (watch)
npm run dev

# Lint
npm run lint

Changelog

v2.0.1

• Corrigido: credencial Google Gemini API agora aparece corretamente no n8n (adicionado tipo de credencial próprio)
• README atualizado com documentação completa dos providers

v2.0.0

• Multi-provider: adicionado suporte a Google Gemini e Anthropic Claude
• Lista de modelos dinâmica carregada via API (substituiu lista estática)
• Token tracking multi-format (OpenAI, Anthropic, Google)
• Parâmetros por provider com ranges corretos
• Criado tipo de credencial Google Gemini API
• Compatibilidade retroativa: workflows existentes com NVIDIA continuam funcionando

v1.0.5

• Suporte a NVIDIA NIM com lista estática de modelos

Notas Importantes

• Este nó não é standalone: precisa ser conectado a um AI Agent, AI Chain ou outro nó compatível
• Credenciais obrigatórias: cada provider requer sua própria credencial configurada
• NVIDIA NIM — tier gratuito para avaliação: a API pública da NVIDIA em integrate.api.nvidia.com é gratuita para testes com créditos iniciais, mas não é recomendada para produção. Para produção, utilize uma instância NIM própria ou um plano dedicado da NVIDIA
• Google e Anthropic: possuem tiers gratuitos com limites de uso — verifique as tabelas de preço de cada provedor para uso intensivo

License

MIT

Author

Kristian Email: [email protected]

Links Úteis

• NVIDIA Build - Catálogo de Modelos
• Google AI Studio - API Keys
• Anthropic Console
• Documentação n8n
• Repositório no GitHub

Este projeto é fornecido "no estado em que se encontra", sem garantias de qualquer tipo. Os mantenedores não se responsabilizam por quaisquer danos ou perdas resultantes do uso deste software.