How to Use Aion-RP 1.0 (8B) in Codex
Aion-RP 1.0 (8B) is trained for character roleplay and creative writing. Its fine-tuned base model is designed for natural, varied prose; start at temperature 0.7 because the maker warns that 1.0 can produce nonsense.
Prompts to try with Aion-RP 1.0 (8B) in Codex
Copy an example into Codex, or ask in your own words.
Use Aion-RP 1.0 (8B) at temperature 0.7 to draft 12 lines for the harbor guard described in this project's character notes. Include greetings, refusals, and reluctant help; keep each line under 25 words and show me the draft.
Read this project's opening scene and use Aion-RP 1.0 (8B) to draft three responses to the player's refusal. Preserve the established facts and format the drafts like the existing dialogue entries.
Use Aion-RP 1.0 (8B) to rewrite the merchant's dialogue in the selected file. Give her clipped sentences and dry humor, preserve every quest clue, and present a proposed diff.
Use Aion-RP 1.0 (8B) at temperature 0.7 to draft a 250-word continuation of the story excerpt in this project. Follow the character notes, retain past tense, and stop before the player makes a decision.
Use Aion-RP 1.0 (8B) to draft eight short conversations for the tavern characters in this repository. Supply their motives as detailed instructions, keep each conversation under 120 words, and save the drafts for review.
How to set up Aion-RP 1.0 (8B) in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex 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-RP 1.0 (8B)
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-rp-llama-3.1-8b", "input": { "messages": [ { "role": "system" } ] } }'
Then paste one of the prompts above: Codex finds Aion-RP 1.0 (8B) on Spiral, shows the price and runs it.
Aion-RP 1.0 (8B) providers and prices
Spiral runs Aion-RP 1.0 (8B) through OpenRouter. Open a card for today's price, with every fee included.
Up to $0.008557 per run at the default inputs. $1.04 per 1M input tokens, $2.08 per 1M output tokens.
Settings you can ask for
Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Top p | 0 to 1 | ||
| Max tokens | 1 to 29491 | The most output tokens to generate. | |
| Temperature | 0 to 2 |
Every API field of AionLabs: Aion-RP 1.0 (8B) is on its tool page: open its card above.
What can you do with Aion-RP 1.0 (8B) in Codex?
Draft game dialogue and interactive fiction from the character notes in your project. Use the coding agent to place reviewed prose into the project's existing content format.
Interactive character roleplay
Play opposite a fictional character with a defined voice and motive. Ask for one reply at a time, leaving your character's decisions to you.
Game character dialogue
Draft greetings, refusals, rumors, and quest conversations from a character brief. Specify what the character knows so the draft has a clear boundary.
Fiction scene continuations
Continue a scene from its final paragraph using a stated viewpoint, tense, and next story beat.
Dialogue rewrites
Rewrite a conversation with sharper differences between speakers. Supply each speaker's goal and ask to preserve the underlying events.
Tabletop encounter rehearsal
Rehearse a conversation with a suspicious guard, reluctant witness, or rival adventurer before a session. Define the character's secrets and conditions for cooperation.
Branching story drafts
Draft separate responses to player choices for a text adventure or visual novel. Review each branch against the same scene facts.
Character voice exploration
Try several voices for the same fictional character by changing diction, rhythm, and attitude while keeping the character's motive fixed.
More on Aion-RP 1.0 (8B) and Codex
Overview
Aion-RP 1.0 (8B) in other agents
Questions about Aion-RP 1.0 (8B) in Codex
Can Codex use Aion-RP 1.0 (8B)?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Aion-RP 1.0 (8B) like any built-in tool.
How much does Aion-RP 1.0 (8B) cost in Codex?
Up to $0.008557 per run at the default inputs. $1.04 per 1M input tokens, $2.08 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-RP 1.0 (8B) in Codex?
No. Spiral runs Aion-RP 1.0 (8B) 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-RP 1.0 (8B) in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Aion-RP 1.0 (8B) runs?
Aion-RP 1.0 (8B) runs in the background. Codex starts the run, checks on it and gives you the text, json when it's ready.
What is Aion-RP 1.0 good at?
Character roleplay and creative writing are its documented focus. Try it for fictional conversations, scene continuations, and dialogue drafts.
Is Aion-RP 1.0 an instruction-tuned model?
It is a fine-tuned base model designed for natural, varied writing. Start with fiction and character work when evaluating whether it fits your task.
What temperature should I use?
Start at 0.7, the maker's recommended value. The maker specifically warns that 1.0 can sometimes produce nonsensical output.
What should I put in the system instructions?
Detailed system instructions can improve output. For roleplay, try specifying the character's voice, motives, knowledge, and who controls each character.
Can Aion-RP 1.0 handle an ongoing character conversation?
Yes, the maker documents multi-turn conversations. Give it the relevant conversation history and ask it to stop before writing your next reply.
Start using Aion-RP 1.0 (8B) in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


