[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [Aion 3.0](https://spiral.ai/integrations/muse-code/aion-3-0)

# How to Use Aion 3.0 in Muse 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.

|  |  |
| --- | --- |
| Model | Aion 3.0 |
| Available through | OpenRouter |
| Category | LLM |
| Price | Up to $0.032086 per run at the default inputs. $3.90 per 1M input tokens, $7.80 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 in Muse Code

- 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 Muse Code

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

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse 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**: 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",
    "input": {
      "messages": [
        {
          "role": "system"
        }
      ]
    }
  }'
```

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## Aion 3.0 tools and prices

- [AionLabs: Aion-3.0](https://spiral.ai/tools/openrouter/aion-labs/aion-3.0) (OpenRouter): 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

| 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 in Muse 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.

## Overview

- [OpenRouter](https://spiral.ai/providers/openrouter)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## Aion 3.0 in other agents

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

## More Muse Code guides

- [Aion 2.0](https://spiral.ai/integrations/muse-code/aion-2-0)
- [Aion 3.0 Mini](https://spiral.ai/integrations/muse-code/aion-3-0-mini)
- [bible-api.com random Bible verse](https://spiral.ai/integrations/muse-code/bible-api-com-random-bible-verse)
- [Aion 3.5](https://spiral.ai/integrations/muse-code/aion-3-5)
- [bible-api.com Bible translations](https://spiral.ai/integrations/muse-code/bible-api-com-bible-translations)
- [Aion 3.5 Mini](https://spiral.ai/integrations/muse-code/aion-3-5-mini)

## Questions about Aion 3.0 in Muse Code

**Can Muse Code use Aion 3.0?**

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

**How much does Aion 3.0 cost in Muse 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 Muse Code plan is separate.

**Do I need an OpenRouter account to use Aion 3.0 in Muse 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 Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while Aion 3.0 runs?**

Aion 3.0 runs in the background. Muse 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.

