[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Aion 3.5](https://spiral.ai/integrations/opencode/aion-3-5)

# How to Use Aion 3.5 in opencode

Aion 3.5 is built for roleplay and fiction that needs stronger structure, tension, and conflict. It combines contributions from specialized models and provides a 262,144-token context window for story material and conversation history.

|  |  |
| --- | --- |
| Model | Aion 3.5 |
| 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.5 in opencode

- Use Aion 3.5 to read this project's character notes and draft a 600-word confrontation between the protagonist and antagonist. Preserve established facts and give each character an incompatible objective.
- Use Aion 3.5 to propose three branches for the quest dialogue in this project. For each branch, write the player's choice, the character's response, and a later story consequence.
- Use Aion 3.5 to revise the opening scene in this project's narrative files. Keep its ending unchanged, but introduce an obstacle that raises the stakes. Return a proposed revision under 800 words.
- Use Aion 3.5 to draft twelve short dialogue lines for the merchant described in this project. Divide them among greeting, bargaining, suspicion, and refusal, keeping the character's motives consistent.
- Use Aion 3.5 to review the game's story outline for conflicts that resolve too easily. Propose five complications, explain their consequences, and identify which established facts each proposal depends on.

## How to set up Aion 3.5 in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

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

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

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

Then paste one of the prompts above: opencode finds Aion 3.5 on Spiral, shows the price and runs it.

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

## Aion 3.5 tools and prices

- [AionLabs: Aion 3.5](https://spiral.ai/tools/openrouter/aion-labs/aion-3.5) (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.5 in opencode?

Draft game dialogue and branching scenes from the story material in your project with Aion 3.5. Use it for narrative work such as character motives, competing goals, and consequences.

### Interactive character roleplay

Try Aion 3.5 as a fictional character with a defined goal, while reserving the player's actions and decisions for the player.

### Scenes with escalating stakes

Give Aion 3.5 a character's objective and an obstacle, then request a scene where each attempted solution creates another complication.

### Branching game dialogue

Ask Aion 3.5 to draft dialogue choices with different consequences, using your supplied character motives and story rules.

### Tabletop adventure preparation

Use Aion 3.5 to propose rival factions, conflicting agendas, and encounters that give players consequential choices.

### Serial fiction planning

Supply Aion 3.5 with the story so far and request the next episode's outline, including unresolved conflicts and an ending hook.

### Revision for dramatic conflict

Ask Aion 3.5 to revise a flat exchange so the characters pursue incompatible goals while preserving the scene's established outcome.

## Overview

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

## Aion 3.5 in other agents

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

## More opencode guides

- [Aion 3.0 Mini](https://spiral.ai/integrations/opencode/aion-3-0-mini)
- [Aion 3.5 Mini](https://spiral.ai/integrations/opencode/aion-3-5-mini)
- [Aion 3.0](https://spiral.ai/integrations/opencode/aion-3-0)
- [Aion-RP 1.0 (8B)](https://spiral.ai/integrations/opencode/aion-rp-1-0-8b)
- [Aion 2.0](https://spiral.ai/integrations/opencode/aion-2-0)
- [Amazon Nova 2 Lite](https://spiral.ai/integrations/opencode/amazon-nova-2-lite)

## Questions about Aion 3.5 in opencode

**Can opencode use Aion 3.5?**

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

**How much does Aion 3.5 cost in opencode?**

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

**Do I need an OpenRouter account to use Aion 3.5 in opencode?**

No. Spiral runs Aion 3.5 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.5 in opencode?**

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

**Does opencode wait while Aion 3.5 runs?**

Aion 3.5 runs in the background. opencode starts the run, checks on it and gives you the text, json when it's ready.

**What is Aion 3.5 good at?**

Aion 3.5 is designed for roleplay and storytelling, with documented emphasis on narrative structure, tension, and conflict. Suggested uses include character dialogue, scene revisions, and branching fiction.

**How much story context can Aion 3.5 handle?**

Its context window is 262,144 tokens. When supplying a manuscript or conversation history, reserve room for instructions and generation.

**How long can an Aion 3.5 answer be?**

The completion limit is 32,768 tokens, shared between internal reasoning and visible text. Request a scene or chapter at a time rather than treating that limit as a promised manuscript length.

**Can Aion 3.5 work directly from pictures or audio?**

Aion 3.5 is documented as text in and text out. Supply a written description or transcript when developing a story from visual or audio material.

**How should I prompt Aion 3.5 for fiction?**

A suggested starting point is to specify viewpoint, character goals, the obstacle, established facts, and the scene's endpoint. For interactive roleplay, state who controls each character and where the response should stop.

