OpenRouter Setup
Overview
When available for your account, you can use your own OpenRouter API key with AI Coach and Bot Chat. You choose a model and pay for its usage through your OpenRouter account. Chastify's permissions, action limits, and provider availability still apply.
AI Coach, Bot Chat, and the general account OpenRouter setting have separate configurations. Saving a key in one place does not configure every AI feature.
Why Is Demo AI Rate-Limited?
Demo AI uses a shared hosted service. Its availability, model, and allowances depend on the current service configuration and your account. Check the usage information and any rate-limit message shown in the app.
Using your own key moves provider usage to your OpenRouter account; it does not make requests unlimited. OpenRouter credit limits, model quotas, provider capacity, and Chastify's feature restrictions can still prevent a request.
Creating an OpenRouter Account
- Create an account or sign in at OpenRouter.
- Review the models you want to use and their current pricing.
- Add credits if your selected model requires them. A Chastify membership does not fund your personal OpenRouter balance.
Creating an API Key
- Open OpenRouter API Keys and create a key.
- Give it a recognizable name, such as Chastify. Consider a dedicated key with a spending limit.
- Copy the key when it is created; OpenRouter does not show the full secret again later.
- Add it to the appropriate Chastify settings below.
OpenRouter supports key-specific spending limits. Review those settings in its API key documentation.
Treat your key like a password. Do not include it in screenshots, shared prompts, or support messages. If it is exposed, revoke it in OpenRouter, create a replacement, and update every Chastify configuration that used it.
Choosing a Model
Use Chastify's model picker or enter an exact OpenRouter model ID. Availability and prices change, so check the current model information instead of copying an old example.
The model inspection panel can show input/output pricing, image-input support, reasoning requirements, and prompt-cache support. For images or AI photo review, choose a model that accepts image inputs. See Task Photo Verification for the separate review and visibility rules.
Model price alone does not establish how well it follows instructions. Test a normal conversation and check any requested action's result before relying on the configuration. Enabling reasoning can affect usage and response time; some models require it.
Free Models (:free)
Use a :free model ID only when that variant appears in the current catalog. Appending :free to an arbitrary ID does not create a supported free model. Free variants can have different availability and rate limits from their paid counterparts; see OpenRouter's free-model guide.
Free models have usage quotas. Paid models can also encounter rate limits or provider outages. Check the actual error and OpenRouter's current limits before changing models or repeatedly retrying.
Demo AI vs. Bring Your Own Key
| Option | Provider setup | Usage to check |
|---|---|---|
| Demo AI | Uses the hosted demo configuration when available. | Demo availability and allowance shown in the app. |
| AI Plan | Uses the hosted plan routing available to your account. | Current plan models, usage, and limits. |
| Your OpenRouter key | Uses the key and model saved for that coach or feature. | Your OpenRouter credits, key limits, model pricing, and provider limits. |
Turn off AI Plan routing before configuring your own provider. A saved personal key does not mean it is being used while a different route is selected.
Setting Up in Chastify
AI Coach
- Open AI Coach settings and turn off AI Plan if it is enabled.
- Under Basic Configuration, select OpenRouter if the API Provider selector is shown.
- Enter your API key and choose a model.
- Review the coach's enabled features, enable it, and save.
- Send a message and check the response or reported error.
See AI Coach for permissions and Hardcore Mode restrictions. A masked key field with Saved means a key is already stored; the app does not display the saved secret again.
Bot Chat
- Open the bot conversation's AI Settings.
- Turn off AI Plan and Use Custom Server if either is selected.
- Enter the OpenRouter API Key and choose an AI Model.
- Select Save & Enable, then test a message.
These settings are separate from AI Coach. Do not assume that changing AI Coach's key also changes Bot Chat's key. If OpenRouter setup is unavailable, check the provider choices offered to your account.
Bot Chat web search and website reading
Bot Chat can retrieve information from outside Chastify by searching the web or reading a website you link in your message. These features work only with models routed through OpenRouter and are not available with MiniMax models. Custom servers and local models do not provide this browsing support.
- Search the web: explicitly ask, for example, “Search the web for recent research on habit formation and include sources.” Phrases such as “search online” or “look up” also request a search.
- Read a website: paste the full
https://orhttp://URL in your current message and say what you want to know, for example, “Read this page and explain its main recommendations: [paste the full URL here].”
If your message contains a URL, the bot reads that page instead of starting a general search. It does not automatically follow links from the page. A search can include reading a relevant result when more detail is needed.
Browsing is read-only: the bot uses the retrieved information in its reply without carrying out lock or device actions in that turn. Send any separate action request in a new message. Website reading does not give the bot access to your signed-in browser accounts or let it operate a website for you.
Check the browsing result shown with the reply and any source links provided. If a page cannot be read or its contents are incomplete, the bot should say so. A reply based on the model's existing knowledge is not proof that it retrieved current information.
If browsing does not work, check the active model and provider in AI Settings, choose a non-MiniMax OpenRouter model, and try an explicit search request or a full URL. Provider availability and usage limits still apply.
General account OpenRouter setting
The separate OpenRouter account setting is used by features such as programmable quiz generation. Save a key and model there when you want those features to use a dedicated configuration.
Features using this general setting prefer a complete general key/model pair, then an eligible Bot Chat pair, then an OpenRouter AI Coach pair. Removing the general key can therefore restore a fallback to a coach's saved key. It does not remove or revoke those other keys.
Costs and privacy
Chastify encrypts saved API keys and makes provider requests from its server. The selected conversation context and any submitted images needed for the request are sent to OpenRouter and the selected provider. This is not local-only processing. Provider logging and retention policies vary; review OpenRouter's provider privacy guidance.
Review usage in OpenRouter, especially after changing models or enabling features that make additional AI requests. Model context, generated responses, and reasoning can affect usage. See Coach Memory & Proactive Nudges for background coach behavior.
Troubleshooting
| Problem | What to check |
|---|---|
| Invalid or revoked key | Replace the key in the settings for the feature that failed, then save. |
| Insufficient credits or spending limit | Check your OpenRouter balance and the limit on that specific key. |
| Rate limit or temporarily unavailable provider | Wait before retrying and review OpenRouter's current limits. A paid model does not guarantee immediate availability. |
| Model not found or image rejected | Confirm the exact model ID and its image-input support in the current catalog. |
| The app still uses AI Plan or another provider | Check the selected route in that coach's settings; a saved key alone does not switch it. |
| The coach replies but an action does not happen | Check the action result, enabled permissions, and lock state. A successful provider response does not authorize every action. |
For provider errors, consult OpenRouter's error guide. When reporting a problem, include the model ID and error message, with credentials removed.