n8n-nodes-deepseek-v4

Nó comunitário do n8n para os modelos DeepSeek V4 (deepseek-v4-flash e deepseek-v4-pro), com controle completo do Thinking Mode.

Novidades da v0.3.0

• 🔥 Compatível com o update DeepSeek-V4-Flash-0731 (31/07/2026)
• ✅ Fix do erro 400 The reasoning_content in the thinking mode must be passed back to the API — o Chat Model agora devolve o reasoning_content à API automaticamente durante loops de tool calls do AI Agent
• ✅ Fix do vazamento de pensamentos — o raciocínio não aparece mais no texto de saída, a menos que Return Thinking Content esteja ativado
• ✅ Novo nível de esforço Low (reasoning_effort: "low")
• ⚠️ Aliases legados removidos — deepseek-chat e deepseek-reasoner foram aposentados pela DeepSeek em 24/07/2026 e não funcionam mais

Modelos suportados

Os aliases deepseek-chat e deepseek-reasoner foram retirados do ar pela DeepSeek em 24/07/2026. Migre para os IDs acima — basta trocar o campo model.

Features

• ✅ Thinking Mode toggle — Desabilite, ou habilite com low, high ou max effort
• ✅ Retorna reasoning_content separado do content (opcional)
• ✅ Passback automático de reasoning_content em tool calls (thinking mode compatível com AI Agent + ferramentas)
• ✅ Parâmetros temperature, top_p, presence_penalty, frequency_penalty são automaticamente omitidos quando thinking está ativo (evita conflito com a API)
• ✅ Suporte a JSON Output Mode (response_format: json_object)
• ✅ Stop sequences configuráveis
• ✅ Custom Base URL (útil para proxies OpenAI-compatible)

Instalação

Via npm (produção)

npm install n8n-nodes-deepseek-v4-thinking-fix

Via n8n UI

Vá em Settings → Community Nodes → Install e busque n8n-nodes-deepseek-v4-thinking-fix.

Desenvolvimento local

cd n8n-nodes-deepseek-v4
npm install
npm run build
# Copie a pasta para ~/.n8n/custom/ ou use npm link

Configuração da Credencial

1. Acesse platform.deepseek.com e gere uma API Key
2. No n8n, vá em Credentials → New → DeepSeek API
3. Insira a API Key e salve

Parâmetros do Nó

Saída

{
  "content": "Resposta final do modelo",
  "reasoning_content": "Chain-of-thought (apenas se thinking ativo e Return habilitado)",
  "model": "deepseek-v4-flash",
  "usage": {
    "prompt_tokens": 100,
    "completion_tokens": 200,
    "total_tokens": 300
  },
  "finish_reason": "stop"
}

Chat Model (AI Agent) — Thinking + Tools sem erro 400

O nó DeepSeek V4 Chat Model pode ser conectado como Chat Model de um AI Agent. A partir da v0.3.0:

• Com Thinking ativado, o nó preserva o reasoning_content das respostas e o devolve à API nas requisições seguintes do loop de tool calls — eliminando o erro 400: The reasoning_content in the thinking mode must be passed back to the API.
• Com Return Thinking Content desativado (padrão), o raciocínio não vaza para o texto visível da resposta.
• Atenção ao Max Tokens: no thinking mode, os tokens de raciocínio consomem o mesmo orçamento de saída. Um valor muito baixo pode truncar a resposta final.

Por que desabilitar o Thinking?

O Thinking Mode consome mais tokens e é mais lento. Para tarefas simples (classificação, extração, tradução, geração de texto direto), desabilitá-lo é mais eficiente e barato. O nó envia explicitamente {"thinking": {"type": "disabled"}} para garantir que o modelo não use reasoning mesmo quando o default da API for enabled.

Licença

MIT