n8n custom node for VolcEngine AI services including chat completion and code completion
npm install n8n-nodes-volcengine-ai-enhanced

This is an enhanced n8n community node for VolcEngine Ark (火山方舟) AI services, forked and improved from crazyyanchao/n8n-nodes-volcengine-ai.
This project is based on the excellent work by @crazyyanchao. We extend our sincere thanks for the original implementation.
Original Repository: crazyyanchao/n8n-nodes-volcengine-ai
This enhanced version introduces the following major improvements:
disabled: Force disable deep thinkingenabled: Force enable deep thinking with reasoning chain outputauto: Model automatically decides when to use deep thinkingThis node provides:
- Dynamic Endpoint Selection: Choose from live endpoints loaded from VolcEngine Ark
- Chat Completion: Intelligent conversation capabilities with multi-turn support
- Thinking Mode: Enable deep reasoning for complex tasks
- Rich Parameter Configuration: Temperature, max tokens, penalties, response format, etc.
- LangChain Integration: Compatible with n8n's AI chain and agent workflows
Follow the installation guide in the n8n community nodes documentation.
``bash`
npm install n8n-nodes-volcengine-ai-enhanced
1. Clone this repository
2. Run npm installnpm run build
3. Run dist
4. Copy the folder to your n8n custom nodes directory
To use this node, you need to configure the VolcEngine AI Enhanced API credentials:
1. Access Token: Your VolcEngine AI API token (for model API calls)
- Used for chat completion requests
- Supports both Bearer and X-Api-Access-Key authentication
2. Access Key ID (AK): Your VolcEngine Access Key ID
- Required for ListEndpoints API calls
- Used for HMAC-SHA256 signature authentication
3. Secret Access Key (SK): Your VolcEngine Secret Access Key
- Required for ListEndpoints API calls
- Used for HMAC-SHA256 signature authentication
4. Region: VolcEngine region (default: cn-beijing)
- Used for API endpoint selection
1. Register VolcEngine Account: Visit VolcEngine Official Website to register
2. Enable Ark Service: Enable VolcEngine Ark service in the console
3. Create API Token: Create an API token in the VolcEngine console for model API calls
4. Create Access Key: Create an Access Key (AK/SK) in the VolcEngine console for ListEndpoints API
1. Install the Node: Install this community node in your n8n instance
2. Configure Credentials:
- Add "VolcEngine AI Enhanced API" credentials
- Fill in Access Token, Access Key ID, Secret Access Key, and Region
3. Add Node to Workflow:
- Add "VolcengineAi Chat Model (Enhanced)" node to your workflow
- Connect it to AI Chain or AI Agent nodes
4. Select Endpoint:
- Choose an endpoint from the dropdown (dynamically loaded)
- Or manually enter an endpoint ID
5. Configure Options (optional):
- Enable Thinking Mode if your model supports it
- Adjust temperature, max tokens, etc.
6. Execute Workflow: Run the workflow to get AI responses
For models that support deep thinking (e.g., DeepSeek R1, DeepSeek V3.2):
1. Select your endpoint
2. In Options, set Thinking Mode to:
- disabled: No thinking chain outputenabled
- : Always output thinking chainauto
- : Let the model decide
```
[AI Chain] → [VolcengineAi Chat Model (Enhanced)] → [Output]
The enhanced node provides the language model to the AI Chain, which can then process complex workflows with reasoning capabilities.
- Base URL: Override default API endpoint
- Frequency Penalty: Reduce repetitive content (-2 to 2)
- Max Retries: Maximum retry attempts
- Maximum Number of Tokens: Max output length (up to 32768)
- Presence Penalty: Encourage new topics (-2 to 2)
- Reasoning Effort: Control reasoning token usage (low/medium/high)
- Response Format: Text or JSON output
- Sampling Temperature: Control randomness (0-2)
- Thinking Mode: Enable/disable/auto deep thinking
- Timeout: Request timeout in milliseconds
- Top P: Nucleus sampling diversity (0-1)
- Minimum n8n Version: 1.0.0
- Node.js Version: >=22.16
- Tested Version: n8n 1.0.0+
* n8n Community Nodes Documentation
* VolcEngine Ark Documentation
* VolcEngine Ark API Reference
* VolcEngine Ark Deep Thinking Guide
* VolcEngine Official Website
MIT License - Same as the original project
Contributions are welcome! Please feel free to submit a Pull Request.
- This node requires a valid VolcEngine account with Ark service enabled
- Please ensure compliance with VolcEngine's terms of use and API call limits
- The ListEndpoints API requires AK/SK authentication
- Thinking mode is only available for models that support it (e.g., DeepSeek R1, DeepSeek V3.2)
---
Forked from: crazyyanchao/n8n-nodes-volcengine-ai
Maintained by: @foxtwobao