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

# How to Use Aion 3.0 in Codex

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 Codex

- 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 Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

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

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

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

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 Codex guides](https://spiral.ai/integrations/codex)

## 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)
- [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)
- [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 Codex guides

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

## Questions about Aion 3.0 in Codex

**Can Codex use Aion 3.0?**

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

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

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

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

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

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

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

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

