RisuAI API: FreeTheAI Custom API Setup
RisuAI connects through its Custom API model (OpenAI Compatible format). On the web version, turn on Force Plain Fetch so requests go straight to FreeTheAI.
Steps
Open the bot settings
Open Settings (gear), then Chat Bot.
Choose Custom API
Set the model to Custom API and the format to OpenAI Compatible.
Fill in the connection
Enter the URL, your key in Key/Password, and a model ID in Request Model, using the values above.
Web version only: Force Plain Fetch
Go to Settings, Advanced Settings, turn on Show Unrecommended Settings, then turn on Force Plain Fetch. Without it RisuAI sends requests through its own relay, which FreeTheAI does not accept.
How this guide was checked: Checked against RisuAI's source (Custom API model, request URL handling, Force Plain Fetch) on 2026-09-29.
Tips
- A base URL ending in /v1 also works; RisuAI adds /chat/completions.
- The desktop and mobile apps do not need Force Plain Fetch.
Troubleshooting
RisuAI says relay_not_supported. How do I fix it?
Turn on Force Plain Fetch under Settings, Advanced Settings (after enabling Show Unrecommended Settings). RisuAI then calls FreeTheAI directly from your browser.
Which model should I use?
glm-5.3 is a strong default for roleplay. See freetheai.org/models for every model and its price.
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.