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

# How to Use Particle-1 in Grok

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, no API key |

## Prompts to try with Particle-1 in Grok

- Use Particle-1 to analyze the compiler error and code pasted above. Rank three likely causes and give me the smallest check for each.
- Use Particle-1 to review the React component pasted above for broken row selection. Propose a correction and describe the regression tests.
- Use Particle-1 to compare the SQL transformations pasted above. Explain where product IDs change type and suggest checks for failed joins.
- Use Particle-1 to turn the feature request above into an implementation plan. List acceptance criteria, likely edge cases, and required verification.
- Use Particle-1 with low reasoning effort to explain the short function pasted above in five sentences, including its inputs, return value, and failure behavior.

## How to set up Particle-1 in Grok

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

### Use the Grok connector

1. **Add a custom connector**: In Grok open Settings › Connect Apps, then Add a custom connector. Name it Spiral, paste this URL, leave Headers empty and click Add MCP.

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

2. **Sign in to Spiral and approve**: Grok opens Spiral: sign in, pick the organization and click Authorize. Spiral gives the connection its own API key; Grok never sees it, and you can remove the connection under Settings › Connected apps.

3. **Check that it is connected**: Connect Apps › Custom shows Spiral as Connected. It works in every Grok chat and Grok bot.

### Use the Spiral skill

1. **Send Grok 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 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: Grok finds Particle-1 on Spiral, shows the price and runs it.

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

## 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 Grok?

Turn pasted code, error traces, and requirements into a focused engineering plan with Particle-1. Ask for evidence behind each diagnosis and a short verification checklist.

### 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 Grok guides](https://spiral.ai/integrations/grok)

## 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 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)
- [n8n](https://spiral.ai/integrations/n8n/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 Grok guides

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

## Questions about Particle-1 in Grok

**Can Grok use Particle-1?**

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

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

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 Grok plan is separate.

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

No. Spiral runs Particle-1 on its own OpenRouter account. You sign in to Spiral once and never paste a key.

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

About two minutes: add a custom connector, then sign in to Spiral and approve, then check that it is connected.

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

Particle-1 runs in the background. Grok 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.

