[Integrations](https://spiral.ai/integrations) › [n8n](https://spiral.ai/integrations/n8n) › [Particle-1](https://spiral.ai/integrations/n8n/particle-1)

# How to Use Particle-1 in n8n

Particle-1 is built for debugging, code changes, and data engineering. Post-trained on DeepSeek V4.1 Flash, it targets fewer reasoning and tool-call tokens while keeping task accuracy close to that model.

|  |  |
| --- | --- |
| Model | Particle-1 |
| Available through | OpenRouter |
| Category | LLM |
| Price | Up to $0.002667 per run at the default inputs. $0.078 per 1M input tokens, $0.65 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Particle-1 in n8n

- Each morning, use Particle-1 to review the supplied build-error feed. Group repeated failures and give each distinct error a likely cause and next check.
- After each failed data job, use Particle-1 to inspect the supplied SQL and error messages. Flag type mismatches and propose targeted validation queries.
- Every weekday, use Particle-1 to review incoming bug descriptions. Draft reproduction steps and acceptance criteria, and mark missing evidence.
- Each evening, use Particle-1 to compare today's supplied test failures with yesterday's. Identify new failures and propose one investigation step for each.
- Every Friday, use Particle-1 to review the supplied engineering change summaries. List changes that need explicit edge-case tests or documentation.

## How to set up Particle-1 in n8n

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send n8n this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Create a key**: Create a key under API keys in the console.

2. **Add an MCP Client node**: In a workflow, add an MCP Client node (or, under an AI Agent node, an MCP Client Tool) and set:

```text
https://api.spiral.ai/mcp
```

3. **Pick a tool**: The node lists Spiral's tools. In an MCP Client node pick one, such as `run`, and give it its arguments:

```json
{
  "provider": "fal",
  "model": "fal-ai/flux/schnell",
  "input": { "prompt": "a lighthouse at dawn" },
  "wait": true
}
```

4. **Run Particle-1 in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds Particle-1, prices it and runs it each time the step fires.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Particle-1**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "openrouter",
    "model": "particle-ai/particle-1",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: n8n finds Particle-1 on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/n8n

## Particle-1 tools and prices

- [Particle AI: Particle-1](https://spiral.ai/tools/openrouter/particle-ai/particle-1) (OpenRouter): Up to $0.002667 per run at the default inputs. $0.091 per 1M input tokens, $0.65 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| seed |  | — |  |
| stop |  | — |  |
| min_p | 0 to 1 | — |  |
| tools |  | — |  |
| top_k | 0 to … | — |  |
| top_p | 0 to 1 | — |  |

## What can you do with Particle-1 in n8n?

Turn recurring engineering errors into investigation briefs with Particle-1. Use scheduled reviews to collect evidence, rank likely causes, and propose checks for an engineer.

### Fix a failing build

Use Particle-1 to inspect compiler errors, identify the cause, propose a targeted fix, and verify the build.

### Repair a React interaction

Ask Particle-1 to correct broken navigation or row selection and check the affected behavior.

### Correct dbt transformations

Have Particle-1 trace inconsistent types or key generation through a dbt project and propose tests.

### Implement a codebase change

Give Particle-1 a concrete requirement and acceptance criteria, then request an implementation with regression checks.

### Plan a debugging session

Provide an error trace and relevant code. Ask Particle-1 for ranked hypotheses and checks that distinguish them.

### Triage recurring engineering failures

Use Particle-1 to review incoming build errors or data-job failures and draft investigation steps.

### Produce structured engineering reports

Ask Particle-1 for JSON summaries of errors, proposed fixes, and verification evidence, then validate the results.

## Overview

- [OpenRouter](https://spiral.ai/providers/openrouter)
- [All n8n guides](https://spiral.ai/integrations/n8n)

## Particle-1 in other agents

- [Amp](https://spiral.ai/integrations/amp/particle-1)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/particle-1)
- [Claude](https://spiral.ai/integrations/claude-desktop/particle-1)
- [Claude Code](https://spiral.ai/integrations/claude-code/particle-1)
- [Cline](https://spiral.ai/integrations/cline/particle-1)
- [Codex](https://spiral.ai/integrations/codex/particle-1)
- [Cursor](https://spiral.ai/integrations/cursor/particle-1)
- [Devin](https://spiral.ai/integrations/devin/particle-1)
- [dots](https://spiral.ai/integrations/dots/particle-1)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/particle-1)
- [Gemini](https://spiral.ai/integrations/gemini/particle-1)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/particle-1)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/particle-1)
- [goose](https://spiral.ai/integrations/goose/particle-1)
- [Grok](https://spiral.ai/integrations/grok/particle-1)
- [Grok Build](https://spiral.ai/integrations/grok-build/particle-1)
- [Hermes](https://spiral.ai/integrations/hermes/particle-1)
- [Instinct](https://spiral.ai/integrations/instinct/particle-1)
- [Manus](https://spiral.ai/integrations/manus/particle-1)
- [Muse](https://spiral.ai/integrations/muse/particle-1)
- [Muse Code](https://spiral.ai/integrations/muse-code/particle-1)
- [Notion](https://spiral.ai/integrations/notion/particle-1)
- [OpenClaw](https://spiral.ai/integrations/openclaw/particle-1)
- [opencode](https://spiral.ai/integrations/opencode/particle-1)
- [Perplexity](https://spiral.ai/integrations/perplexity/particle-1)
- [Raycast](https://spiral.ai/integrations/raycast/particle-1)
- [VS Code](https://spiral.ai/integrations/vscode/particle-1)
- [Windsurf](https://spiral.ai/integrations/windsurf/particle-1)
- [Zapier](https://spiral.ai/integrations/zapier/particle-1)

## More n8n guides

- [Pareto Latest](https://spiral.ai/integrations/n8n/pareto-latest)
- [Perceptron Mk1](https://spiral.ai/integrations/n8n/perceptron-mk1)
- [Pareto 26.9](https://spiral.ai/integrations/n8n/pareto-26-9)
- [Perceptron Mk1.5](https://spiral.ai/integrations/n8n/perceptron-mk1-5)
- [Pareto 26.10 Preview](https://spiral.ai/integrations/n8n/pareto-26-10-preview)
- [Phi-4](https://spiral.ai/integrations/n8n/phi-4)

## Questions about Particle-1 in n8n

**Can n8n use Particle-1?**

Yes. Add Spiral to n8n as an MCP server, and n8n can find and run Particle-1 like any built-in tool.

**How much does Particle-1 cost in n8n?**

Up to $0.002667 per run at the default inputs. $0.078 per 1M input tokens, $0.65 per 1M output tokens. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your n8n plan is separate.

**Do I need an OpenRouter account to use Particle-1 in n8n?**

You need no OpenRouter account. n8n uses one Spiral API key for every tool, and Spiral runs Particle-1 on its own OpenRouter account.

**How long does it take to set up Particle-1 in n8n?**

About two minutes: create a key, then add an MCP Client node, then pick a tool.

**Does n8n wait while Particle-1 runs?**

Particle-1 runs in the background. n8n starts the run, checks on it and gives you the text, json when it's ready.

**What is Particle-1 best suited for?**

Particle-1 focuses on software engineering and data engineering. Its published evaluations cover terminal tasks, React fixes, dbt projects, and codebase changes.

**How does Particle-1 compare with DeepSeek V4.1 Flash?**

Particle-1 is post-trained on DeepSeek V4.1 Flash to use fewer tokens. Particle reports 28.4% to 52.2% fewer output tokens across four engineering benchmarks, with pass rates within the base model's confidence intervals.

**How much context and output can Particle-1 handle?**

The context window holds 1,048,576 tokens across the prompt and completion. The output ceiling is 131,072 tokens, including reasoning.

**When should I reduce Particle-1's reasoning?**

Consider lower effort for straightforward explanations or narrow edits, and compare results on representative tasks. Reasoning is enabled by default and consumes part of the output allowance.

**Can I rely on Particle-1 to match a JSON schema?**

Validate the result before your application uses it. Particle's documentation distinguishes valid JSON from guaranteed compliance with your application's schema.

