# 在 SillyTavern(酒馆)中接入 WanAPIs

> SillyTavern 选 Chat Completion → Custom (OpenAI-compatible),Base URL 填 https://api.wanapis.com/v1,一把 Key 用 Claude、DeepSeek、Gemini 做剧情和角色扮演。每一步都在 SillyTavern 1.19.0 上实测过。

网页版:https://wanapis.com/docs/sillytavern

最后验证:SillyTavern 1.19.0 · 2026-10-03(连接、模型列表、Test Message、流式角色对话、一行命令均实测)

SillyTavern(酒馆)通过「Custom (OpenAI-compatible)」接入任何 OpenAI 兼容接口。把地址指向 WanAPIs,一把 Key 就能用 Claude、DeepSeek、Gemini 等模型做剧情、跑团和角色扮演。下面每一步都在 SillyTavern 1.19.0 上实测过。注意:WanAPIs 禁止生成色情和成人内容,也不提供破限预设,详见使用规范。

## 一览

| 项目 | 取值 |
| --- | --- |
| 接口地址(Base URL) | https://api.wanapis.com/v1(只填到 /v1) |
| SillyTavern 选项 | API 选 Chat Completion;Chat Completion Source 选 Custom (OpenAI-compatible) |
| 模型列表 | 从 /v1/models 自动获取,只显示 Key 第一个分组里的模型 |
| 流式输出 | 支持 |
| Claude 推荐分组 | claude max(我们用角色卡实测过,会全程保持人设) |
| 计费 | 按 token 计费,单价见模型市场;同一模型在不同分组的单价不同 |
| 数据 | 网关不保存对话正文,也不用请求内容训练模型;调用记录(时间、模型、token 数等,不含正文)保留 90 天;请求会转发给上游模型服务商处理 |
| 内容规范 | 禁止生成色情和成人内容;不支持、也不提供破限预设 |

## 接入步骤

### 1. 创建一把专用 Key,选好分组

在 WanAPIs 控制台打开「API 密钥」→「创建 API 密钥」。只用 Claude:分组选 claude max,这是我们推荐给 Claude 角色扮演的分组,单价高于默认分组。Claude 和 DeepSeek、Gemini 等都想用:在「分组调用顺序」里把 claude max 排第一,再点「添加分组」加上 default。这样 claude max 里有的模型(Claude)走 claude max,没有的自动走 default。同时把「跨分组重试」关掉,Claude 出错时就不会改走其他分组。建议给这把 Key 设一个额度上限。

**控制台 → API 密钥 → 创建 API 密钥**

```
名称:         SillyTavern
分组调用顺序: 1. claude max
              2. default
跨分组重试:   关闭
额度:         按需设上限(可选)
```

### 2. 打开 API 连接,选 Custom (OpenAI-compatible)

在 SillyTavern 顶部点插头图标(API Connections)。API 选 Chat Completion,Chat Completion Source 选 Custom (OpenAI-compatible)。

### 3. 填地址和 Key,点 Connect

Custom Endpoint (Base URL) 填 https://api.wanapis.com/v1,只填到 /v1,不要加 /chat/completions,酒馆会自己补上。Custom API Key 粘贴 sk- 开头的 Key。点 Connect,下方出现绿色的 Valid 就是连通了。

**SillyTavern → API Connections**

```
Custom Endpoint (Base URL): https://api.wanapis.com/v1
Custom API Key:             sk-xxx
```

![SillyTavern 1.19.0 的 API Connections 面板:Custom (OpenAI-compatible) 填好 WanAPIs 地址后显示 Valid](https://wanapis.com/docs/sillytavern-connect.png)

*SillyTavern 1.19.0 实测:Base URL 填到 /v1,连接后显示 Valid*

### 4. 选模型

在 Available Models 下拉框里选模型,会自动填进 Enter a Model ID。下拉框只列出 Key 第一个分组里的模型,DeepSeek、Gemini 这类 default 分组的模型不在列表里,直接在 Enter a Model ID 里填模型名就行。Prompt Post-Processing 保持 None。

**推荐模型(填进 Enter a Model ID)**

```
claude-sonnet-5-5   # claude max 分组,角色扮演主力
claude-opus-5-5     # claude max 分组,更强也更贵
deepseek-v4-flash   # default 分组,便宜,适合长对话
gemini-2.5-pro      # default 分组
```

### 5. Test Message 测试,存成连接配置

点 Test Message,收到回复就可以开始聊天了。建议点顶部 Connection Profile 旁边的「Create a new connection profile」图标,把这套设置存成一个连接配置,以后一键切换。

### 6. (可选)一行命令快速填写

不想手动点选的话,在聊天输入框粘贴下面这行并回车,会切到 Custom (OpenAI-compatible) 并填好 Base URL 和模型。之后仍要按第 3 步在 Custom API Key 里粘贴 Key 并点 Connect;已经存过连接配置的,再点「Update a connection profile」图标保存。

**SillyTavern 聊天输入框**

```
/api custom | /api-url api=custom connect=false https://api.wanapis.com/v1 | /model claude-sonnet-5-5
```

## 已知限制

- 未在 SillyTavern 中实测:工具调用(Function Calling)、图片输入(Vision)、结构化输出。
- Claude 4.7 及以后的型号(包括 claude-sonnet-5-5、claude-opus-5-5)官方不再接受自定义的 temperature / top_p / top_k,WanAPIs 会自动去掉这几个参数,所以在酒馆里调这些滑块对这些型号不起作用。
- Claude 4.6 及以后的型号官方不支持预填回复(Start Reply With / assistant prefill),开启后可能报错。
- Reasoning Effort 请保持 Auto。对 claude-sonnet-5-5 等型号设成具体档位,目前可能出错。
- 模型列表只显示 Key 第一个分组里的模型,其他分组的模型要手动填写模型名。

## 常见问题

### 报「接口地址少了 /v1」(invalid_base_url)怎么办?

Base URL 漏了 /v1。改成 https://api.wanapis.com/v1,再点一次 Connect。

### 报「分组 … 下模型 … 无可用渠道」怎么办?

模型名写错了(大小写不对、末尾多了空格),或者这把 Key 的分组里没有这个模型。从模型市场复制模型名;要用 default 分组的模型,在 Key 的「分组调用顺序」里加上 default。

### 提示额度不足?

账户余额用完了,或者这把 Key 的额度上限用完了。去控制台「钱包」充值,或在「API 密钥」里调高这把 Key 的额度。

### Available Models 里为什么只有 Claude?

列表只显示 Key 第一个分组(claude max)里的模型。default 分组的模型照样能用,在 Enter a Model ID 里手动填模型名就行。

### 能写 NSFW 内容或用破限预设吗?

不能。WanAPIs 的使用规范禁止生成色情和成人内容,我们也不提供、不支持破限预设。剧情冒险、跑团、长篇创作和日常角色扮演都可以放心用。

### 我的对话会被保存或拿去训练吗?

网关不保存对话正文,也不会用任何请求内容训练模型。调用记录(时间、模型、token 数等,不含正文)保留 90 天,方便你在控制台对账。请求会转发给上游模型服务商处理。详见官网「数据与安全」页。

### 其他酒馆类客户端怎么填?

看客户端要的是什么:要「Base URL / API 地址」的,填 https://api.wanapis.com/v1;要「完整请求地址 / Proxy URL」的(比如 JanitorAI),填 https://api.wanapis.com/v1/chat/completions。网页版客户端在浏览器里直接发请求,WanAPIs 已支持跨域(CORS)。

### 遇到账单、额度或模型不可用的问题找谁?

发邮件到 support@wanapis.com,或在控制台联系客服。

---

本文由 WanAPIs 官网生成,和网页版内容同步。全部教程的 Markdown 目录:https://wanapis.com/docs/index.md
