[Integrations](https://spiral.ai/integrations) › [VS Code](https://spiral.ai/integrations/vscode) › [Aion 3.0 Mini](https://spiral.ai/integrations/vscode/aion-3-0-mini)

# How to Use Aion 3.0 Mini in VS Code

Aion 3.0 Mini is built for roleplay, character dialogue, and stories with tension and conflict. It uses DeepSeek models, while Aion 3.0 uses GLM models.

|  |  |
| --- | --- |
| Model | Aion 3.0 Mini |
| Available through | OpenRouter |
| Category | LLM |
| Price | Up to $0.007487 per run at the default inputs. $0.91 per 1M input tokens, $1.82 per 1M output tokens. |
| Returns | text, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Aion 3.0 Mini in VS Code

- Use Aion 3.0 Mini to draft a 12-turn conversation from this project's character notes. Give the merchant and player conflicting goals, preserve established lore, and save the draft beside the existing dialogue.
- Use Aion 3.0 Mini to propose three branches for the tavern encounter in this project: cooperation, refusal, and deception. Follow the existing dialogue format and keep each branch under 250 words.
- Use Aion 3.0 Mini to rewrite the opening scene in this project's narrative files. Preserve its events, introduce the protagonist's immediate obstacle earlier, and show me the proposed changes.
- Use Aion 3.0 Mini with reasoning enabled to draft five short NPC exchanges from the project's faction notes. Make each dispute turn on a different competing interest and keep each exchange under 200 words.
- Use Aion 3.0 Mini to create a 600-word quest dialogue draft from this project's quest brief. Include a bargain, a refusal, and a consequence, then place it in a new draft file.

## How to set up Aion 3.0 Mini in VS Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to VS Code on the console's Agents & MCP page, or run:

```bash
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
```

2. **Sign in**: VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

### Use the Spiral skill

1. **Send VS Code 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 Aion 3.0 Mini**: 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": "aion-labs/aion-3.0-mini",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

Then paste one of the prompts above: VS Code finds Aion 3.0 Mini on Spiral, shows the price and runs it.

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

## Aion 3.0 Mini tools and prices

- [AionLabs: Aion-3.0-Mini](https://spiral.ai/tools/openrouter/aion-labs/aion-3.0-mini) (OpenRouter): Up to $0.007487 per run at the default inputs. $0.91 per 1M input tokens, $1.82 per 1M output tokens.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| tools |  | — |  |
| top_p | 0 to 1 | — |  |
| reasoning |  | — | Reasoning effort; reasoning tokens count toward max_tokens. |
| max_tokens | 1 to 32768 | — | The most output tokens to generate. |
| temperature | 0 to 2 | — |  |
| tool_choice |  | — |  |

## What can you do with Aion 3.0 Mini in VS Code?

Turn game briefs and character notes into playable dialogue drafts with Aion 3.0 Mini. Use your coding agent to place reviewed scenes into the project's existing narrative format.

### Interactive character conversations

Write exchanges in which a character pursues a specific goal. Define what the character knows and leave the user's actions for the user to decide.

### Branching game dialogue

Draft conversations with distinct responses to cooperation, suspicion, and refusal. Give each branch a consequence for the next scene.

### Tabletop encounters

Prepare an encounter around conflicting motives, a secret, and an approaching deadline. Include peaceful and confrontational ways forward.

### Fiction scene drafts

Turn a scene brief into prose with a defined viewpoint, an immediate obstacle, and a consequential ending.

### Conflict rewrites

Rework a flat exchange so the characters want incompatible outcomes. Request subtext and concrete stakes while preserving established events.

### Serialized story installments

Draft the next short installment from a canon summary and the previous ending. Set a word target and identify the unresolved question it should advance.

### Audio drama scripts

Write a dialogue-led scene with speaker labels and brief sound cues. Build the conflict through what the characters say and withhold.

### Alternative plot outlines

Explore several consequences of one difficult choice. Ask for a different escalation and ending in each outline.

## Overview

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

## Aion 3.0 Mini in other agents

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

## More VS Code guides

- [Aion 3.0](https://spiral.ai/integrations/vscode/aion-3-0)
- [Aion 3.5](https://spiral.ai/integrations/vscode/aion-3-5)
- [Aion 2.0](https://spiral.ai/integrations/vscode/aion-2-0)
- [Aion 3.5 Mini](https://spiral.ai/integrations/vscode/aion-3-5-mini)
- [bible-api.com random Bible verse](https://spiral.ai/integrations/vscode/bible-api-com-random-bible-verse)
- [Aion-RP 1.0 (8B)](https://spiral.ai/integrations/vscode/aion-rp-1-0-8b)

## Questions about Aion 3.0 Mini in VS Code

**Can VS Code use Aion 3.0 Mini?**

Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Aion 3.0 Mini like any built-in tool.

**How much does Aion 3.0 Mini cost in VS Code?**

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

**Do I need an OpenRouter account to use Aion 3.0 Mini in VS Code?**

No. Spiral runs Aion 3.0 Mini on its own OpenRouter account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Aion 3.0 Mini in VS Code?**

About two minutes: add the hosted server, then sign in.

**Does VS Code wait while Aion 3.0 Mini runs?**

Aion 3.0 Mini runs in the background. VS Code starts the run, checks on it and gives you the text, json when it's ready.

**What is Aion 3.0 Mini good at?**

Roleplay and storytelling are its stated focus. Consider it for character exchanges, scene drafts, and plots built around competing goals.

**How does Aion 3.0 Mini differ from Aion 3.0?**

Aion 3.0 Mini uses DeepSeek models, while Aion 3.0 uses GLM models. Aion Labs describes both as targeting narrative structure, tension, and conflict.

**How much context can Aion 3.0 Mini handle?**

Its context window is 131,072 tokens. For ongoing fiction, supply a concise canon summary alongside the current scene rather than treating that limit as a reason to include every draft.

**How long can an Aion 3.0 Mini response be?**

It supports up to 32,768 completion tokens. Internal reasoning also consumes the generation budget, so allow room for both planning and the visible answer.

**Should I disable reasoning for creative writing?**

Keep reasoning enabled as a starting point. Aion Labs says these models are tuned for reasoning and warns that disabling it can degrade output.

