[Integrations](https://spiral.ai/integrations) › [Notion](https://spiral.ai/integrations/notion) › [Aion 3.0](https://spiral.ai/integrations/notion/aion-3-0)

# How to Use Aion 3.0 in Notion

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 Notion

- Every Monday, use Aion 3.0 to draft five tabletop encounter ideas from the campaign recap supplied for that run. Include a motive, an obstacle, and two possible resolutions for each.
- Each morning, use Aion 3.0 to create one 200-word fiction exercise about conflicting loyalties. Include a setting, two competing goals, and a decision for the writer to resolve.
- Every Friday, use Aion 3.0 to draft a 700-word serial installment from the latest approved recap. Preserve established events and end with one unresolved choice.
- Once a week, use Aion 3.0 to propose three escalating complications for the current story outline supplied with the run. Explain which character decision triggers each complication.
- Each evening, use Aion 3.0 with reasoning enabled to draft a short conversation between two fictional rivals from the supplied character descriptions. Keep it under 400 words and give both a reason to compromise.

## How to set up Aion 3.0 in Notion

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

### Use the Spiral skill

1. **Send Notion 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. **Allow custom MCP servers**: A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP servers. Where members may install only approved connections, also add Spiral under Approved connections › Add approved connection › Custom MCP server with the URL below.

2. **Add Spiral to a custom agent**: Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server. Paste this URL, name it Spiral, keep OAuth and click Connect.

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

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

4. **Run Aion 3.0 in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds Aion 3.0, 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 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: Notion finds Aion 3.0 on Spiral, shows the price and runs it.

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

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

Aion 3.0 can supply recurring drafts for a fiction serial, roleplay campaign, or writing practice. Give each run the current recap and constraints, and collect the results for review.

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

## 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)
- [Muse Code](https://spiral.ai/integrations/muse-code/aion-3-0)
- [n8n](https://spiral.ai/integrations/n8n/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 Notion guides

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

## Questions about Aion 3.0 in Notion

**Can Notion use Aion 3.0?**

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

**How much does Aion 3.0 cost in Notion?**

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

**Do I need an OpenRouter account to use Aion 3.0 in Notion?**

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 Notion?**

About two minutes: allow custom MCP servers, then add Spiral to a custom agent, then sign in to Spiral and approve.

**Does Notion wait while Aion 3.0 runs?**

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

