How to Use Aion 3.0 in VS Code
Aion 3.0 is built for roleplay and fiction that needs stronger plot structure, tension, and conflict. Multiple specialized models contribute to each response, making collaborative storytelling its defining focus.
Prompts to try with Aion 3.0 in VS Code
Copy an example into VS Code, or ask in your own words.
Use Aion 3.0 to read the project's character notes and draft 12 lines for a suspicious innkeeper. Preserve established names and give each line a clear conversational purpose.
Use Aion 3.0 to turn the current quest outline into three dialogue branches: cooperation, refusal, and bargaining. Return a JSON draft and validate it against the project's dialogue schema.
Use Aion 3.0 to revise the opening scene in the narrative files. Keep the existing events and ending, but introduce a concrete obstacle within the first 150 words.
Use Aion 3.0 to draft five encounter concepts from the project's setting notes. Give each a conflicting pair of motives and a resolution that does not require combat.
Use Aion 3.0 with reasoning enabled to draft a 700-word confrontation from the project's plot outline. Preserve the protagonist's knowledge and list proposed changes separately.
How to set up Aion 3.0 in VS Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
Use Add to VS Code on the console's Agents & MCP page, or run:
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}' - 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
- Send VS Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Aion 3.0
One request; the result comes back by polling or a webhook.
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", "input": { "messages": [ { "role": "system" } ] } }'
Then paste one of the prompts above: VS Code finds Aion 3.0 on Spiral, shows the price and runs it.
Aion 3.0 providers and prices
Spiral runs Aion 3.0 through OpenRouter. Open a card for today's price, with every fee included.
Up to $0.032086 per run at the default inputs. $3.90 per 1M input tokens, $7.80 per 1M output tokens.
Settings you can ask for
Ask VS Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Top p | 0 to 1 | ||
| Max tokens | 1 to 32768 | The most output tokens to generate. | |
| Temperature | 0 to 2 |
Every API field of AionLabs: Aion-3.0 is on its tool page: open its card above.
What can you do with Aion 3.0 in VS Code?
Aion 3.0 can help you draft dialogue, encounters, and story branches for a game project. Use the project's narrative files as constraints, then review generated text and validate any JSON before importing it.
Interactive character conversations
Use Aion 3.0 to play a fictional character with a clear goal, a secret, and a reason to resist the reader.
Branching game dialogue
Ask Aion 3.0 for dialogue choices with distinct consequences, then review each branch against the game's established events.
Scene revisions
Give Aion 3.0 a scene and request a revision that raises the stakes while preserving its point of view and ending.
Tabletop encounters
Have Aion 3.0 draft an encounter with competing motives, a time constraint, and several possible resolutions.
Plot outlines
Use Aion 3.0 to turn a premise into escalating story beats, with a concrete consequence attached to each major choice.
Serialized fiction drafts
Ask Aion 3.0 to draft one installment from a supplied recap, ending on an unresolved decision for editorial review.
More on Aion 3.0 and VS Code
Overview
Aion 3.0 in other agents
Questions about Aion 3.0 in VS Code
Can VS Code use Aion 3.0?
Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run Aion 3.0 like any built-in tool.
How much does Aion 3.0 cost in VS Code?
Up to $0.032086 per run at the default inputs. $3.90 per 1M input tokens, $7.80 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 in VS Code?
No. Spiral runs Aion 3.0 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 in VS Code?
About two minutes: add the hosted server, then sign in.
Does VS Code wait while Aion 3.0 runs?
Aion 3.0 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 good at?
Aion 3.0 focuses on roleplay and storytelling, especially narrative structure, tension, and conflict. Try it for character conversations, scene drafts, and branching story choices.
How much text can Aion 3.0 handle?
Aion 3.0 has a 131,072-token context window and a maximum completion of 32,768 tokens. Internal reasoning shares the completion allowance with the visible answer.
Should I leave reasoning enabled?
Yes. Aion Labs says its models are tuned for reasoning and that disabling it can reduce output quality.
Why might Aion 3.0 return no visible answer?
Reasoning can consume the entire completion budget before visible text begins. Allow room for both reasoning and the requested answer, or request a shorter answer.
Can Aion 3.0 return story data as JSON?
Yes, but JSON output does not enforce a JSON schema. Validate required keys and value types before using generated dialogue or quest data in an application.
Start using Aion 3.0 in VS Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into VS Code:
set up https://spiral.ai/SKILL.md


