Description
n8n-nodes-volcengine-next
n8n community node — Volcengine Ark (火山方舟) Doubao Chat Model，通过 OpenAI 兼容接口接入豆包系列大模型，支持 Thinking 模式与工具调用。
方舟文档：
节点说明
| 节点 | 类型 | 说明 |
|——|——|——|
| Volcengine Ark Chat Model (Next) | AI Language Model | 接入 n8n AI Agent / AI Chain 使用 |
安装
在 n8n 设置 → Community Nodes 中搜索并安装：
n8n-nodes-volcengine-next
或通过 npm 手动安装（自托管）：
npm install n8n-nodes-volcengine-next
凭据配置
在 n8n 凭据页面新建 Volcengine Ark API (Next)，填入：
| 字段 | 说明 |
|——|——|
| API Key | 火山方舟控制台 → API Key 管理 中获取 |
| Base URL | 默认 https://ark.cn-beijing.volces.com/api/v3，如使用其他区域可修改 |
> 获取 API Key：控制台 API Key 管理
支持的模型
节点会自动从 /models 端点动态加载可用模型；若接口不可达，以下静态列表作为兜底：
| 模型 ID | 说明 |
|———|——|
| doubao-seed-2-0-pro-260215 | Doubao Seed 2.0 Pro（默认） |
| doubao-seed-2-0-lite-260215 | Doubao Seed 2.0 Lite |
| doubao-seed-1-6-251015 | Doubao Seed 1.6 标准版 |
| doubao-seed-1-6-thinking-250715 | Doubao Seed 1.6 Thinking（支持深度推理） |
| doubao-seed-1-6-flash-250828 | Doubao Seed 1.6 极速版 |
| doubao-seed-1-6-lite-251015 | Doubao Seed 1.6 轻量版 |
| doubao-pro-32k | Doubao Pro 32K |
| doubao-lite-32k | Doubao Lite 32K |
Options 选项
| 选项 | 类型 | 默认值 | 说明 |
|——|——|——–|——|
| Thinking Mode | Disabled / Enabled | Disabled | 启用后模型输出 reasoning_content（推理过程）；需使用 thinking 类模型 |
| Stream | boolean | true | 是否流式输出；AI Agent 场景保持开启 |
| Parallel Tool Calls | boolean | false | 是否允许并行工具调用；关闭可控制 Agent 迭代消耗 |
| Sampling Temperature | number 0–2 | 0.7 | 采样温度 |
| Top P | number 0–1 | 1 | 核采样阈值 |
| Frequency Penalty | number -2~2 | 0 | 频率惩罚（抑制重复） |
| Presence Penalty | number -2~2 | 0 | 存在惩罚（鼓励新话题） |
| Maximum Number of Tokens | number | -1 | 最大输出 token 数；-1 使用模型默认值 |
| Response Format | Text / JSON Object | Text | JSON 格式时请在 Prompt 中包含 “json” 关键词 |
| Timeout (ms) | number | 360000 | 请求超时时间（毫秒） |
| Max Retries | number | 2 | 最大重试次数 |
| Additional Model Arguments | JSON | — | 传递给 Ark API 的额外参数（浅合并到 modelKwargs） |
关于 Thinking 模式
Thinking 模式适用于需要复杂推理的任务（数学、代码分析、多步骤规划等）。
- 启用 Thinking 模式时，temperature / top_p 等采样参数对推理阶段无效。
- 推荐使用
doubao-seed-1-6-thinking或 Seed 2.0 系列模型。 - 当 Thinking 模式禁用时，节点会自动将
reasoning_content流式增量镜像到普通 assistant text，确保 n8n AI Agent 能正常聚合输出。 - 多轮工具调用场景下，节点会自动将上一轮的
reasoning_content注入到后续请求，符合火山方舟 API 要求。 - 火山方舟 OpenAI 兼容接口
- 模型列表
- API Key 管理
