惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

V
V2EX
酷 壳 – CoolShell
酷 壳 – CoolShell
美团技术团队
有赞技术团队
有赞技术团队
Hugging Face - Blog
Hugging Face - Blog
罗磊的独立博客
S
SegmentFault 最新的问题
D
Docker
博客园 - 司徒正美
雷峰网
雷峰网
V
Visual Studio Blog
云风的 BLOG
云风的 BLOG
G
Google Developers Blog
The GitHub Blog
The GitHub Blog
A
About on SuperTechFans
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
博客园 - Franky
月光博客
月光博客
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
H
Hackread – Cybersecurity News, Data Breaches, AI and More
T
The Blog of Author Tim Ferriss
Google DeepMind News
Google DeepMind News
MyScale Blog
MyScale Blog
MongoDB | Blog
MongoDB | Blog

OpenRouter Blog

Using OpenRouter With LangChain (ChatOpenRouter) — OpenRouter Blog How to Evaluate LLM Provider Performance — OpenRouter Blog Image Generation API on OpenRouter: Generate + Read Images — OpenRouter Blog Classifiers: Track What Your Agents Do and What It Costs — OpenRouter Blog Transcription on OpenRouter: Whisper & More STT Models — OpenRouter Blog OpenRouter Prompt Caching: What Cached Tokens Cost — OpenRouter Blog One API for Image, Video, Audio, Embeddings & Transcription — OpenRouter Blog A New Look for OpenRouter — OpenRouter Blog Why Use OpenRouter for DeepSeek — OpenRouter Blog Choosing the Optimal Image Input Detail Level in LLMs — OpenRouter Blog DeepSeek V4 Is Earning Agentic Token Share — OpenRouter Blog The Open Weight Models that Matter: June 2026 — OpenRouter Blog The OpenRouter MCP Server — OpenRouter Blog Introducing the Unified Image API — OpenRouter Blog The AI Governance Checklist That Maps to Your Stack — OpenRouter Blog Enforce AI Data Residency at the Routing Layer — OpenRouter Blog OpenRouter vs Portkey: Routing Network vs Control Plane — OpenRouter Blog OpenRouter vs LiteLLM: Managed vs Self-Hosted Gateway — OpenRouter Blog Connect OpenClaw to OpenRouter: One Key, Failover, Free Models — OpenRouter Blog A Robot is Sprinting Towards You: Do You Want it Running on Claude or Grok? Kilo Code + OpenRouter: Setup, Routing, and Free Models — OpenRouter Blog Codex CLI with OpenRouter: config.toml Setup and Models — OpenRouter Blog Claude Code with OpenRouter: Setup, Models, and Costs — OpenRouter Blog How to Use OpenRouter With Any Coding Agent or AI Tool — OpenRouter Blog Subagent: Let Your Model Delegate the Busywork — OpenRouter Blog Free LLM API in 2026: 13 Options Ranked and Compared — OpenRouter Blog How to Enforce Agentic AI Governance at the API Layer — OpenRouter Blog Keep Your Agent Running When Models Disappear — OpenRouter Blog Hermes Agent + OpenRouter: Setup, Model Choice & Routing Config — OpenRouter Blog Lowest-Cost LLM Inference: The Complete OpenRouter Guide — OpenRouter Blog
Connect SillyTavern to OpenRouter: Setup, Models, Fixes —...
OpenRouter · 2026-06-18 · via OpenRouter Blog

Using several AI models in SillyTavern normally means signing up with Anthropic, Google, Mistral, and a few others separately, each with its own account and often a $20 per month subscription. One OpenRouter key replaces that with a single credit balance and 300+ models from 70+ providers in one SillyTavern dropdown. Many are free to start, and you can be chatting in about five minutes.

This guide covers the connection steps, the roleplay models to try, the settings that actually matter, and fixes for the errors SillyTavern users hit most.

Connect SillyTavern to OpenRouter in five steps

Work in SillyTavern’s API Connections panel. The goal is to point SillyTavern at OpenRouter, verify your key, pick a model, and send one test message before a longer chat.

  1. Open the API Connections panel (the plug icon in the top bar) and set API Type to Chat Completion.
  2. Set Chat Completion Source to OpenRouter.
  3. Click Authorize to create a key through the OAuth flow, or generate one at openrouter.ai/settings/keys and paste it into the API key field.
  4. Click Connect and wait for SillyTavern to verify the key.
  5. Pick a model from the dropdown, then click Test Message.

Send that test message before you commit to a long session. A successful Connect only proves SillyTavern can verify your key. Generation can still fail if the model is unavailable, the provider route can’t serve the request, the slug is wrong, your account can’t reach that model, or your prompt exceeds the model’s context window.

Use Chat Completion for almost every setup. Image inlining and tool calling only work through Chat Completion, which matches how current OpenRouter models expect prompts. Text Completion gives finer control over raw prompt formatting for advanced users, but it’s not the place to start. If OpenRouter only shows up under Chat Completion sources in your version, that’s expected. Full setup details live in the SillyTavern OpenRouter docs.

Free models and the $10 credit rule

Models tagged :free cost $0 per token, but request limits still apply, and that catches people out.

Account stateDaily :free capPer-minute cap
Under $10 in credits50 requests/day20 requests/min
$10 or more in credits1,000 requests/day20 requests/min

The $10 is a one-time credit purchase, not a subscription, and it stays usable for paid models. OpenRouter adds no markup on provider pricing, so the catalog price is what you pay, and failed requests aren’t billed. If you already pay a provider directly and want to keep that contract, bring your own key instead.

Charges on a “free” model almost always mean per-token billing and request limits got crossed. Check whether you actually selected a paid model, enabled a paid fallback route, or used a slug that doesn’t end in :free. Hitting the free-model ceiling is a limit problem, not the free model billing you.

Roleplay models to try

DeepSeek V3.2 is the cheap, reliable default for long scenes. For more expressive, less filtered prose, try the Euryale finetunes. When a character card carries complicated instructions the model has to follow, Hermes 4 405B handles it better than most.

Model slugContextIn / Out per 1MFree variantBest for
deepseek/deepseek-v3.2131K$0.23 / $0.34NoCheap, coherent default for long sessions
deepseek/deepseek-r1-0528164K$0.50 / $2.15NoReasoning-heavy scenes and planning
sao10k/l3.3-euryale-70b131K$0.65 / $0.75NoCharacterful RP prose with a long window
gryphe/mythomax-l2-13b4K$0.06 / $0.06NoClassic budget workhorse, tiny context
aion-labs/aion-rp-llama-3.1-8b32K$0.80 / $1.60NoPurpose-built roleplay tune, lightweight
nousresearch/hermes-4-405b131K$1.00 / $3.00NoComplex cards, strict instruction following
z-ai/glm-4.6203K$0.43 / $1.74NoStrong general model
mistralai/mistral-large-2512262K$0.50 / $1.50NoPolished paid option, less filtered

Prices and context windows verified against the OpenRouter catalog on 2026-06-16. Per-token rates change, so confirm on the model’s page before a long session.

Free variants come and go without the model itself changing, and they often run smaller context windows than the paid version. That’s the usual reason a character card starts forgetting mid-scene. Before you build a setup around any free model, check openrouter.ai/models?q=free and confirm the exact :free slug is still live.

Settings and routing that matter

Start with settings that keep the chat stable, then tune once the connection is solid.

  • Turn streaming on so replies appear as the model generates them.
  • Set the context length slider to the model’s real window from the table above. Free variants are smaller, so check the catalog page, not a third-party guide.
  • Leave fallback providers enabled for reliability. Disable them only when you need to control exactly which provider serves the request.
  • Use prompt caching for long-running characters with a big system prompt or repeated lorebook context. It doesn’t make requests free, but it cuts the cost of repeated input across turns.

Two routing suffixes go on the end of a model slug. :nitro sorts to the fastest provider; :floor sorts to the cheapest. Both map to OpenRouter’s provider routing sort options. For long sessions with a fixed character card, :floor plus prompt caching meaningfully reduces cost. For time-sensitive generation, reach for :nitro.

One billing note on streaming: aborting a stream stops processing and billing only for providers that support cancellation. Several don’t, including AWS Bedrock, Groq, Google, Google AI Studio, Minimax, and Mistral. For those, or for non-streaming requests, the model can run to completion and bill the full response.

Keep roleplay chats private

OpenRouter privacy comes down to two layers: what OpenRouter stores, and what the provider serving your request stores. OpenRouter doesn’t store prompts or responses unless you opt into logging, though it keeps usage metadata like token counts and latency. The downstream provider has its own retention policy, which is why routing controls matter.

Enable Zero Data Retention to route only to providers that don’t store prompts or responses, per request or account-wide. OpenRouter may offer a small discount for opting into prompt and completion logging; most roleplay users should leave it off rather than expose character cards and chat histories to logs.

OpenRouter doesn’t filter content itself, but it routes to providers that enforce their own policies, so calling the setup “uncensored” overstates it. If a model keeps refusing or cutting scenes, that’s provider moderation. Switch to a less-filtered model or provider. The trust center has the specifics.

Fix the most common errors

Most SillyTavern and OpenRouter issues fall into a few patterns. Start from the exact error message, then apply the matching fix.

“Could not verify OpenRouter token.” A common error, and the message is misleading. The key is almost always fine; the real cause is a DNS or network issue that stops SillyTavern from reaching openrouter.ai, so the request never gets verified. Confirm the key is active at your keys page, paste it again without trailing spaces, re-Authorize if you used OAuth, and restart. If it persists, switch your DNS resolver to 8.8.8.8 or 1.1.1.1 and restart. DNS is the fix most of the time.

401 error. This means OpenRouter rejected the key SillyTavern sent. Regenerate it, paste it again without trailing spaces, and confirm the account has credits if you’re calling a paid model.

OpenRouter is missing from the source list. Set API Type to Chat Completion first, since it won’t show under other types. Update and restart SillyTavern. Only edit config.yaml on an older or unusual install, where show_openrouter_api: true exists as a workaround, not a default. Check the related SillyTavern issue before changing it.

Empty model dropdown. The account is usually fine; SillyTavern failed to load the list. Refresh the connection and restart. If it still fails, enter the exact model slug from the model page by hand.

Connect works, but generation fails. Connect only proves the key is valid. Switch to another model and test, confirm the account has credits for a paid model, check the slug, and lower the context length if a large card, lorebook, or history is overflowing the window.

Frequently asked questions

How do I connect OpenRouter to SillyTavern?

Open the API Connections panel, set API Type to Chat Completion, choose OpenRouter as the source, click Authorize for an OAuth key or paste one from openrouter.ai/settings/keys, click Connect, pick a model, and send a test message.

Is OpenRouter actually free for SillyTavern?

For models tagged :free, yes, with limits. Free-model usage is capped at 50 requests per day and 20 per minute. Buying $10 in credits once raises the daily cap to 1,000 requests, while the per-minute cap stays the same. It’s not a subscription, and the credit stays usable for paid models.

What is the best free model for SillyTavern roleplay?

meta-llama/llama-3.3-70b-instruct:free is a strong pick, with a 131K context when available. Free model availability changes often, so confirm the exact :free slug is live at openrouter.ai/models?q=free before building a setup around it.

How do I fix “could not verify OpenRouter token”?

It’s usually a DNS or network problem, not a bad key. Switch your DNS to 8.8.8.8 (Google) or 1.1.1.1 (Cloudflare), confirm the key is active, paste it again without trailing spaces, and restart SillyTavern.

Why does my generation stop early?

Check the response’s finish reason first, since the same symptom has several causes: provider moderation, a max-tokens limit, a context-length issue, or streaming behavior. If one provider keeps cutting scenes short, try another model or provider, then raise the max output setting if responses simply end too soon.

OpenRouter or a single-provider key for SillyTavern?

Use a direct key if you only ever use one provider and want the simplest billing. Use OpenRouter if you want one setup for many models, provider routing, fallback when a route goes down, free models to experiment with, and a single credit pool.