Roleplay API

A free OpenAI-compatible API for roleplay clients.

FreeTheAi gives roleplay users one OpenAI-compatible endpoint that works with popular character chat clients. Get a free key in Discord, paste the base URL into your frontend, and choose an exact model alias from the live catalog.

Open roleplay setup guides Browse roleplay models Get a free key

Copy-paste basics

Use the same FreeTheAi gateway everywhere.

SillyTavern, Janitor AI, Chub AI, RisuAI, and character-chat users.

Base URL https://api.freetheai.xyz/v1

Janitor-style full proxy URL https://api.freetheai.xyz/v1/chat/completions

Auth Authorization: Bearer YOUR_FREETHEAI_KEY

Why it works

Built for real clients, not just docs.

Client-ready

Works anywhere that accepts a custom OpenAI-compatible base URL or full chat completions proxy URL.

Streaming-first

Use streaming in roleplay clients so long responses start showing immediately instead of waiting for a full completion.

Live catalog

Copy exact aliases from the model catalog instead of guessing names. The catalog is the source of truth.

Routes

Pick the route your client expects.

POST /v1/chat/completions

The main route for SillyTavern, Janitor AI, Chub AI, RisuAI, and most character chat frontends.

GET /v1/models

Authenticated model list for clients that can fetch a dropdown from your key.

GET /v1/models/full

Expanded catalog for context windows, output limits, image support, and access labels on the public site.

Exact setup

Start with one of these guides.

Each guide includes the right URL format, model field, and common client-specific gotchas.

Roleplay & chat frontends SillyTavern

Power-user roleplay frontend with deep prompt control.

Open guide -> Roleplay & chat frontends Janitor AI

Roleplay site that connects through a reverse proxy.

Open guide -> Roleplay & chat frontends Chub AI

Open roleplay platform with Secrets-based proxy slots.

Open guide -> Roleplay & chat frontends RisuAI

Local-first roleplay client with deep prompt control.

Open guide ->

FAQ

Fast answers.

Does FreeTheAi work with SillyTavern?

Yes. Select Chat Completion, choose Custom OpenAI-compatible, set the base URL to https://api.freetheai.xyz/v1, paste your key, and choose an alias from the model catalog.

What URL should Janitor AI use?

Janitor AI usually wants the full proxy path. Use https://api.freetheai.xyz/v1/chat/completions and your FreeTheAi API key.

Where do I find roleplay model names?

Use https://freetheai.xyz/models and copy exact aliases. If a model is hidden from your key, it requires a different access tier or role.