Chub AI API: FreeTheAI Reverse Proxy Setup
Chub AI uses FreeTheAI as an OpenAI reverse proxy. You enter the base URL and key in Secrets, check the proxy, then choose the model in Configuration.
Steps
Open Secrets
In any chat, open the menu (three lines, top right) and choose Secrets, then OpenAI.
Turn on the reverse proxy
Choose Reverse Proxy instead of your own OpenAI key. Enter the base URL ending in /v1 (not /chat/completions) and your FreeTheAI key.
Check the proxy
Press Check Proxy and wait for the green confirmation. Chub loads the model list from FreeTheAI at this step.
Pick the model
Open the menu again, choose Configuration, then Prompt Structure. Set API to OpenAI and pick a model that freetheai.org/models lists. Save.
How this guide was checked: Checked against Chub's API connection docs and current reverse proxy guides on 2026-09-29.
Tips
- Refresh the page if the model list stays empty after a successful check.
- Chub's list may show models FreeTheAI does not serve. Use IDs that freetheai.org/models lists.
Troubleshooting
Check Proxy fails on Chub. Why?
The URL must be the base URL https://api.freetheai.org/v1. A full /chat/completions URL fails, because Chub adds the path itself.
Can I use FreeTheAI on the Chub mobile site?
Yes. The same Secrets and Configuration menus are in the mobile chat view.
Check Proxy works but no FreeTheAI models appear. What now?
Refresh the page, then look again under Configuration, Prompt Structure. Only models that freetheai.org/models lists work.
Why do I get a 401 error?
The key is wrong or incomplete. Paste the whole ftai_ key (53 characters), with no spaces.
Why do I get a 403 error?
A 403 usually means the account follows no provider of that model, or your email is not confirmed. Follow a provider on freetheai.org/providers, then try again.
It loads for a long time, then shows an error or an empty reply. Why?
The model is busy. Try another model, and check freetheai.org/status.
A model rejects my settings. How do I fix it?
Reset temperature and the other sampling settings to their defaults, then try again.
Which models are good for roleplay on Chub?
GLM, Kimi, and MiniMax models, for example glm-5.3. The models page has a Roleplay filter.
Common errors
- 401: the key is wrong or incomplete. Paste the whole key.
- 403: follow a provider of the model, or confirm your email.
- 404: the model ID or URL is wrong.
- 429: daily limit reached, or too many requests at once.