Connect OpenRouter and choose AI models
Connect your own OpenRouter account, pick a model for each chat, and understand the small background charges you may see.
Updated
ScribbleIt doesn't bill you for AI usage. Instead, it runs on your own OpenRouter account. OpenRouter is a service that gives you one account for many AI models (Claude, GPT, Gemini, DeepSeek and others). You add credits at openrouter.ai, and every AI request you make in ScribbleIt is paid from that balance. Your $25/month subscription covers the app itself.
Until OpenRouter is connected, AI features stay off.
Connect with one click (recommended)
- Click the Settings icon (gear) in the top bar.
- Open the AI & Library tab.
- Under AI provider (OpenRouter), click Connect OpenRouter.
- On openrouter.ai, sign in (or create an account) and approve the connection.
- You're sent back to Settings. You should see "OpenRouter connected." and a green check with Connected and the last few characters of your key.
Tip: you can also connect from the welcome checklist when you first sign up.
Paste a key instead
If you already have an OpenRouter API key, you can paste it.
- Go to Settings > AI & Library.
- Click Paste a key instead.
- Paste your key (it starts with
sk-or-) and click Save. - You should see "Key saved."
Your key is encrypted and only used for your own requests.
Reconnect or disconnect
- To swap to a different OpenRouter account or key, click Reconnect (or paste a new key).
- To remove your key, click Disconnect. AI features turn off until you connect again.
Add credits on OpenRouter
Credits are managed on openrouter.ai, not inside ScribbleIt. If AI replies start failing, the most common reason is an empty OpenRouter balance. Log in to openrouter.ai and add credits, then try your request again.
Choose a model for your chat
You can switch models at any time from the chat panel.
- Look at the row of controls under the chat message box. Click the model button (it shows a chip icon and the current model name).
- A list opens, grouped into:
- Cheap defaults: best quality per dollar, good for everyday drafting.
- Free fallback: zero-cost backup models.
- Premium quality: for final polish and the highest quality.
- Research: models with built-in web search, for finding and citing outside sources.
- Type in the search box to filter by model name or company, then click a model.
Your choice is saved for the chat you're in. The current model name is also shown in small text at the bottom of the chat panel.
Tip: when your cursor isn't in a text box, press Ctrl+Shift+M (Cmd+Shift+M on a Mac) to cycle through models.
Which model should I use? Start with one of the Cheap defaults for drafting and brainstorming. Switch to a Premium quality model when you want a careful final pass. Premium models cost more per request on OpenRouter.
Research models
The Research group has two models: Sonar (research + cite) and Gemini 2.5 Flash + web. They can search the web themselves and cite what they find in APA style.
They still follow the globe button under the message box: they only search the web while web research is on. Click the globe to turn it on. With it on, the assistant searches only when your library, project files and context aren't enough.
Why do I see small charges I didn't make in chat?
A few behind-the-scenes jobs also use your OpenRouter key:
- Document summaries. After you edit a document, ScribbleIt writes a short summary of it. This lets the assistant find content across your chapters without reading every one in full.
- Library indexing. When you upload files to your Library, they're indexed so the assistant can search and cite them. The Library page notes this costs a few cents per hour of transcript.
- Example consolidation. When you build a style note or template from example files, the model you picked as the Consolidation model reads them.
These jobs use inexpensive models and usually cost very little. All of this usage goes through your own OpenRouter account.
Troubleshooting
- "Not connected. AI features will stay off until you connect OpenRouter." Click Connect OpenRouter in Settings > AI & Library.
- "That doesn't look like an OpenRouter key (it starts with sk-or-)." Check that you copied the whole key from openrouter.ai, with no spaces.
- It says Connected, but replies fail with "Model request failed". Check your balance at openrouter.ai and add credits, then click Retry under the failed reply. Some models need a paid balance even when free models still work.
- I only see free models. If your OpenRouter account is on OpenRouter's free tier (no credits purchased), the picker only shows models with a free version. Add credits on openrouter.ai and the full list appears.
- A model I expected isn't in the list. The picker shows a hand-picked set of models rather than everything on OpenRouter. Try another model from the same group.
- The connect page came back with an error. Try Connect OpenRouter again. If it keeps failing, use Paste a key instead, or start a conversation from Help & support.