---
url: https://docs.freetheai.org/guides/risuai.md
description: >-
  Set up FreeTheAI in RisuAI with the Custom API model: URL, key, request model,
  and the Force Plain Fetch setting the web version needs.
---

# RisuAI

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.

Category: [Roleplay apps](/guides/#roleplay-apps). Before you start, you need a FreeTheAI account, an API key, and today's [check-in](/getting-started/check-in).

## Settings

| Setting | Value |
| --- | --- |
| Model | `Custom API` |
| URL | `https://api.freetheai.org/v1/chat/completions` |
| Key/Password | Your FreeTheAI key (`ftai_...`, 53 characters) |
| Request Model | `fta/zai/glm-5.3` |
| Format | `OpenAI Compatible` |

## 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.

## Tips

* A base URL ending in /v1 also works; RisuAI adds /chat/completions.
* The desktop and mobile apps do not need Force Plain Fetch.

## Common questions

### 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?

`fta/zai/glm-5.3` is a strong default for roleplay. See [freetheai.org/models](https://freetheai.org/models) for all free models.

## More help

* [Every API error and its fix](/errors)
* [Limits and the daily reset](/concepts/limits)
* [RisuAI website](https://risuai.net) and [source code](https://github.com/kwaroran/RisuAI)

::: info How this guide was checked
Checked against RisuAI's source (Custom API model, request URL handling, Force Plain Fetch) on 2026-09-29.
:::