Bring Your Own Key (BYOK)¶
Use your own OpenRouter API key to pay for LLM tokens directly. GloriaMundo routes your AI model calls through your OpenRouter account with no markup on the LLM portion. BYOK is available to paid (Pro) subscribers.
What BYOK does¶
When you provide your own OpenRouter key:
- LLM token costs are billed to your OpenRouter account at OpenRouter's rates. GloriaMundo does not take a cut.
- Service costs — sandboxing (E2B), integrations (Composio), image generation, web search, extraction, memory, and browsing — are still billed at standard rates from your GloriaMundo credit pool.
- An active paid (Pro) subscription is required to save, test, or use a key. Trial accounts cannot use BYOK. Eligibility is re-checked every run, so if your subscription lapses your LLM calls automatically fall back to platform credits at standard rates.
What is still billed from your credits¶
Every non-LLM service used during a workflow run:
| Service | Description |
|---|---|
| E2B | Sandboxed Python execution |
| Composio | Third-party integration actions |
| Image generation | Imagen, FLUX, and other image models |
| Web search | Tavily, Serper |
| Extraction | Firecrawl, Tavily Extract |
| Memory | Zep conversation memory |
| Browsing | BrightData web browsing |
| Knowledge | Graphlit document ingestion |
These are services GloriaMundo pays for on your behalf, so the standard rate applies regardless of your BYOK status.
How to set it up¶
BYOK requires an active paid (Pro) subscription — Test key and Save are available to Pro subscribers only.
- Get an OpenRouter API key from openrouter.ai.
- In GloriaMundo, go to Settings and select OpenRouter Key.
- Paste your key into the input field.
- Click Test key to verify it works.
- Once validated, click Save.
Your key is encrypted at rest and never logged or exposed in error reports.
What happens if the key fails¶
If your OpenRouter key is rejected during a workflow run (expired, revoked, or over quota), the run stops with a clear error message:
Your OpenRouter key was rejected. Please check your key in Settings, or remove it to fall back to platform credits.
There is no silent fallback to platform credits. You will always know which account is paying for LLM tokens.
Removing your key¶
Go to Settings > OpenRouter Key and click Remove key. Future LLM calls will use platform credits at standard rates.
Cost display¶
The Virtual Run cost breakdown shows what was charged to your GloriaMundo credits. When BYOK is active:
- The LLM line is not charged from your credits — your LLM tokens were billed to your OpenRouter account — so it is omitted from the breakdown. A note below the breakdown explains that LLM tokens were billed to your OpenRouter account.
- Service costs show the amount debited from your GloriaMundo credits at standard rates.
- The total is labelled "Charged from credits" and reflects only the service costs (plus any subscriber discount).
The preview projection matches the eventual charge: under BYOK the projected LLM cost is excluded, so what you see previewed is what you are charged.
Supported providers¶
BYOK currently supports OpenRouter only. OpenRouter gives you access to models from Anthropic, OpenAI, Google, Meta, Mistral, and others through a single key.