guide

How to Use Janitor AI in 2026: Setup, API Keys & First Chat

A step-by-step guide to using Janitor AI in 2026 — setup, connecting an API key, and starting your first chat, with the common snags and how to fix them.

May 1, 2026 · 9 min read

Affiliate disclosure: Some of the links in this article are affiliate links. We may earn a commission if you sign up for a platform through these links, at no additional cost to you. This doesn't influence our editorial verdicts. Full disclosure →

Janitor AI is one of the most powerful AI roleplay platforms available, and also one of the most confusing for first-time users. The base experience (sign up, browse characters, start chatting) takes thirty seconds. The good experience, the one users on Reddit rave about, requires connecting an external model through a proxy, generating API keys, copying URLs precisely, and occasionally troubleshooting when something silently fails. Most newcomers bounce off the setup before they ever get to the conversations the platform is famous for.

This guide walks through what actually works in 2026, in the order it actually works, with links to the resources that fill in the gaps.

The thirty-second version that works for casual use

Sign up at janitorai.com using an email address (use a secondary email if privacy matters to you). The platform doesn't require identity verification beyond an 18+ checkbox. Browse the character library on the homepage, sorted by popular, new, or trending. Click a character that catches your eye, click "Start Chatting," and you're in.

The default model is JanitorLLM (or JLLM), Janitor's own model. It's fine for casual conversation. It's not the model that makes Janitor famous. If you stop here, you'll have a decent experience that's roughly comparable to what you'd get on Character AI minus the content filters. Most users want more, which is where the proxy setup begins.

The OpenRouter setup that doubles your message quality

OpenRouter is a routing service that connects you to dozens of AI models through a single API. Janitor users typically use OpenRouter to access models like DeepSeek, Anthropic's Claude, and various Llama fine-tunes. The setup takes about five minutes the first time.

Step one: Create a free OpenRouter account. Go to openrouter.ai, click sign up, use the same email or a different one (your choice). The signup is straightforward.

Step two: Generate an API key. Click your profile icon in the top right, go to "Keys," click "Create API Key," give it a name like "Janitor" so you remember what it's for, and click create. The key will appear in a popup. Copy it immediately and save it somewhere safe (a password manager works, or a text file on your device). You will not see this key again after closing the popup. If you lose it, you'll need to generate a new one.

Step three: Pick a model. OpenRouter has both free and paid models. As of early 2026, the free models worth trying include z-ai/glm-4.5-air:free (stable and capable), nousresearch/hermes-3-llama-3.1-405b:free (large and creative), and qwen/qwen3-235b-a22b-thinking-2507 (a reasoning model). The OpenRouter models page lets you filter to free options. Free models share rate limits across all users, so they can be slow during peak times. Worth knowing that the underlying model providers (not OpenRouter itself) are companies like DeepSeek, Anthropic, Meta, and various smaller providers, each with their own terms of service and data practices.

Step four: Configure the proxy in Janitor. Open any character chat, click the menu icon, select "API Settings," choose "Proxy," and click "+ Add Configuration." Give the configuration a name (something like "OpenRouter GLM" so you know what it is). In the model field, enter the exact model name from OpenRouter (for example: z-ai/glm-4.5-air:free with the colon and "free" tag included). For the proxy URL, enter exactly: https://openrouter.ai/api/v1/chat/completions. Don't click the URL link, copy and paste it directly. In the API key field, paste the key you saved in step two. Save the settings.

Step five: Refresh the page. This is the step that breaks the setup for most users. Janitor doesn't always pick up new proxy configurations until you do a full browser refresh. If you skip this step, you'll get errors trying to chat. Refresh, then start a conversation. If the model name and key are correct, you're now chatting through OpenRouter.

The official Janitor help articles have a step-by-step version with screenshots if you get stuck. The OpenRouter quickstart documentation is also useful for understanding how the routing layer works.

The $10 trick that gives you 1,000 messages per day permanently

OpenRouter's free tier has a daily message limit of 50 requests across free models. If you hit it, you wait until tomorrow. There's a workaround that's worth knowing: deposit $10 in OpenRouter credits, and the daily limit on free models permanently increases to 1,000 messages per day, even if you never spend the credits.

This is the single best optimization for serious Janitor users. The $10 isn't a subscription, it's a one-time deposit that sits in your account. It unlocks the higher rate limit on free models forever (or until OpenRouter changes the policy, which they've maintained consistently for over a year). For most users, $10 covers months of use because you're not actually spending the credits, just having them in your account is the activation trigger.

The deposit goes through standard payment processing on OpenRouter directly. Janitor doesn't see your payment details since the transaction is between you and OpenRouter.

Building a character that doesn't immediately break

Janitor's character library has hundreds of thousands of community-created characters, but the quality varies wildly. The best ones have detailed personality definitions, specific behavioral patterns, and example dialogue that anchors the AI's voice. The worst ones are two-line descriptions that produce generic chatbot responses regardless of which model you're using.

If you want to create your own character rather than use community ones, the character card writing guide covers the principles in detail. The Janitor-specific tips: use the personality field for behavioral patterns rather than just adjectives ("speaks in short sentences when annoyed" beats "is grumpy"), use the scenario field to establish setting and context, and use example messages to demonstrate the character's voice rather than describe it. The character template documentation covers Janitor's specific format.

For complex characters with deep backstories, lorebooks let you store world details that activate based on conversation keywords. Janitor supports lorebooks through its character creation interface, and well-built ones dramatically improve consistency across long conversations. The broader character card format (sometimes called "TavernAI cards") originated in the SillyTavern community and is documented in character card specifications that work across most major AI roleplay platforms. Characters built to spec port between platforms with minimal modification, which is useful if you decide to migrate later.

Where the model choice actually matters

Different models on OpenRouter feel different in conversation. Worth knowing the broad strokes before you spend an hour testing each one:

DeepSeek models tend to be smart and follow instructions closely. They work best at low temperature settings (0.1-0.3) and benefit from clear custom prompts. Sometimes the reasoning trace appears in responses, which you may want to hide in settings.

Claude models (the Anthropic family on OpenRouter) produce nuanced, well-written conversation but can be more cautious about edgy content. Worth trying if you want quality over content freedom.

Llama-based models (including the various Hermes and Dolphin fine-tunes) tend to be more permissive on content and more variable in quality. The good ones are excellent. The mediocre ones produce flat responses regardless of how good your character card is.

GLM-4.5 Air has been a community favorite in 2026 for stability and consistent quality. Reasoning is enabled by default, which produces better thinking but slower responses.

The OpenRouter community forums and the Janitor subreddit have ongoing discussions about which models work best for specific use cases. Reading a few recent threads is faster than testing every model yourself.

Custom prompts that change everything

Once you have a working proxy connection, the next quality lever is the custom prompt. This is text that gets prepended to every conversation, telling the model how to behave globally. Most models work much better with a custom prompt than with default settings.

A basic custom prompt establishes that the model is roleplaying, defines tone and style, and may include a content allowance ("explicit content is permitted when contextually appropriate") if you want to avoid the model defaulting to cautious responses. Community resources like Sprout's prompt collection and various Reddit threads have well-tested prompts you can copy and adapt.

The prompt goes in the "Custom Prompt" field in API Settings. Save and refresh after adding it.

When something breaks (and it will)

The most common Janitor errors and their fixes:

Error 401 means your API key isn't being recognized. Check that you copied the entire key without extra spaces, and that the key matches the service you're routing to (OpenRouter keys start with sk-or-, DeepSeek's direct keys start differently).

Empty or repetitive responses usually mean your context size is set too high. Most models work best with 16k or 32k context. Lower it in chat settings if you're getting weird outputs.

"Failed to fetch" or connection errors usually resolve with a page refresh. Janitor's frontend caches connection state and sometimes loses it.

The chat suddenly speaks in a different style usually means you accidentally switched proxy configurations. Check API Settings and confirm you're on the configuration you expected.

For everything else, the Janitor AI Discord and r/JanitorAI subreddit have responsive communities. Most issues have been seen and solved before, often with the exact error message you're experiencing.

The setup pays off. Once your proxy is working and your custom prompt is dialed in, the conversation quality on Janitor through a good model genuinely competes with anything on the commercial AI companion market. The hour you spend learning the system buys you years of better roleplay than the platform's default experience delivers.