Before you start
- Keep the key private. Anyone with it may be able to spend the balance.
- Use a tool that clearly supports OpenRouter keys or custom OpenAI-compatible providers.
- Do not paste the key into public repos, screenshots, shared docs, or random browser extensions.
- If a tool asks for a base URL, use OpenRouter’s current endpoint from its official docs.
The basic setup pattern
- Open the tool’s model provider or API-key settings.
- Choose OpenRouter if it is listed. If it is not, look for a custom OpenAI-compatible provider option.
- Paste the private key exactly as shown on the Boon redemption page.
- Select a model available through OpenRouter.
- Run a short, harmless test prompt before using the key for important work.
How to test safely
Use a prompt that does not include private information, such as: “Write a two-sentence checklist for testing an API key.” If the tool replies, your provider settings are probably correct. If it fails, check the common issues before changing the key.
Common problems
- The tool is still calling a different provider instead of OpenRouter.
- A custom-provider setup is missing the base URL.
- The selected model name is not supported by that tool.
- The key was copied with an extra space.
- The prepaid balance has been used up.
Frequently asked questions
Can I share my OpenRouter key?
No. Treat it like a password. If you think it was exposed, contact support so the gift can be reviewed.
Where should I store the key?
Store it in the trusted app that needs it or in a password manager. Avoid screenshots, notes apps, source code, and chat transcripts.
Which model should I pick first?
Start with a general-purpose model for a simple test, then switch based on the task: coding, long documents, images, speed, or cost.