WanAPIsWanAPIs
注册

在 SillyTavern(酒馆)中接入 WanAPIs

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

免费注册拿 Key 查看模型与价格

一览

接口地址(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 天;请求会转发给上游模型服务商处理
内容规范
禁止生成色情和成人内容;不支持、也不提供破限预设

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

接入步骤

  1. 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. 2

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

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

  3. 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
    SillyTavern 1.19.0 实测:Base URL 填到 /v1,连接后显示 Valid
  4. 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. 5

    Test Message 测试,存成连接配置

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

  6. 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)。

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

发邮件到 [email protected],或在控制台联系客服。

现在就把 SillyTavern(酒馆) 接到 WanAPIs

一个 API Key 调用 GPT、Claude、Gemini、DeepSeek、Kimi、GLM 等模型,国内直连、按 token 实付。

免费开始 完整文档