Aventura Integration

AVELIN API is compatible with Aventura — Free, open-source AI adventure and creative writing application.

Aventura is a free, open-source interactive fiction engine powered by AI. Its killer feature is AI-driven narrative branches — rather than following pre-written paths, Aventura generates unique story branches in real time based on your choices, creating genuinely unpredictable adventures. Every playthrough is different because the AI is composing the story as you go, adapting to your decisions and building on earlier choices.

Perfect for game masters looking for inspiration, interactive fiction enthusiasts, and creative writers who want to explore narrative possibilities. Aventura turns storytelling into a collaborative game between you and the AI. Connect AVELIN for fast, creative model access that keeps the story flowing.

Why AVELIN + Aventura? Leverage AVELIN's frontier models with large context windows and competitive pricing for creative workflows.

Quick Setup

Step 1: Get your AVELIN API key

Sign up at avelin.ai and generate an API key. It will look like sk-ave...xxxx.

Step 2: Configure AVELIN

Most creative tools support OpenAI-compatible endpoints via environment variables or settings:

export OPENAI_API_BASE=https://api.avelin.ai/v1
export OPENAI_API_KEY=sk-avelin-YOUR_KEY

API Reference

EndpointURL
OpenAI-compatiblehttps://api.avelin.ai/v1
Anthropic-compatiblehttps://api.avelin.ai
Use caseModelWhy
Creative writingavelin-proBalanced creativity and coherence
Complex narrativesavelin-ultraDeepest reasoning for story consistency
Quick responsesavelin-fastLow latency for rapid iteration
Long documentsavelin-coding-pro1M context for entire novels

Why AVELIN for Aventura?

  • Large context: 256K-1M tokens for long creative works
  • Prompt caching: ~80% cost reduction on repeated character/world context
  • Model diversity: Switch between models for different creative needs
  • Competitive pricing: Lower per-token costs than direct providers

Troubleshooting

IssueSolution
API key errorVerify OPENAI_API_BASE includes /v1
Character inconsistenciesUse avelin-ultra for better narrative coherence
Slow responsesSwitch to avelin-fast for quicker iteration
Context overflowEnable context summarization or use larger model