SillyTavern怎么接入Gemini：连接设置、费用与400排错
API Key在别的工具里能用，SillyTavern却找不到模型，或一发消息就400。修改预设前，先确认客户端实际发送的协议、地址形状与模型ID。
填Key前先选对接入路径
| 设置 | 本路径填写 | 常见错误 |
|---|---|---|
| API类型 | Chat Completion | 选择Text Completion |
| 来源 | Custom (OpenAI-compatible) | 把这个地址填进另一供应商原生连接 |
| Base URL | https://direct.evolink.ai/v1 | Base里再次加入/chat/completions |
| API Key | EvoLink签发的Key | 使用另一供应商的Key |
| 模型ID | gemini-4-argon | 把页面slug gemini-4当成API模型ID |
https://direct.evolink.ai/v1/chat/completions。客户端会添加路由，所以Base栏使用较短值。EvoLink请求教程提供了该Chat Completions地址，当前模型ID与协议以Gemini模型页为准。加预设前先验证短请求
想区分客户端设置和路由问题，可以使用本地环境变量做最小请求：
curl https://direct.evolink.ai/v1/chat/completions -H "Authorization: Bearer $EVOLINK_API_KEY" -H "Content-Type: application/json" -d '{"model":"gemini-4-argon","messages":[{"role":"user","content":"Reply with OK."}],"max_tokens":2048,"stream":false}'原始请求若成功，只能证明这次凭据、路由和模型调用成立，不证明之后所有工具调用或角色预设都兼容。记录状态与正文，不把Key放进截图或支持日志。
在酒馆里保存自定义连接，发送短测试消息。下拉没有模型时，官方文档允许在供应商没有可用模型列表的情况下手填ID。空列表首先是发现问题，不能直接认定无法生成。
每次恢复一个功能
先只发普通用户消息并取得文字输出，再依次恢复系统/角色提示、多轮历史、流式和工具或扩展。在哪一步失败，就比较修改前后的实际请求。
| 现象 | 优先检查 |
|---|---|
| 401或鉴权失败 | 凭据、目标地址与账户权限 |
| 404或路径错误 | Base、重复后缀与模型可用性 |
| 400参数错误 | 序列化字段、角色和可选功能 |
| 空回复或截断 | 正文、输出预算、finish reason与客户端解析 |
| 请求成功但客户端仍警告 | 模型发现/状态检查与安装版本行为 |
不要只为隐藏失败请求开启“Bypass API status check”。先确认实际生成成功，再判断警告是否来自单独的发现检查。
按完整model-turn错误排查400
Requests ending with a model turn are not supported时，检查最终序列化的对话。界面有用户输入框，不代表发出的最后消息一定是用户轮次；预填、续写、历史转换与扩展都可能改变它。纯文字测试可以开新对话，以真实用户消息结尾，先移除assistant预填或续写设置，再分别恢复。涉及工具时，对照供应商要求查看完整调用/结果序列，不盲删工具记录或改角色名。
SillyTavern文档列有提示词后处理选项，其中某些会去掉工具。转换器不只影响格式，也可能改变功能，要确认具体选项，并在修改后测试目标功能。其他供应商或模型的社区报错只提供线索，不等于已验证本路由修复。
检查长对话用量与缓存
最新消息很短，长历史仍可能增加输入。记录输入、输出、可取得的缓存用量和总账单，用可比请求对照。UI里出现相同角色提示，不能直接证明缓存命中。
gemini.enableSystemPromptCache标为仅适用OpenRouter，不能据此认为自定义EvoLink路径也采用同样行为。保存可以复现的排障记录
记录酒馆版本、连接类型、不含凭据的Base、模型ID、启用功能、HTTP状态、脱敏正文和最小复现。连续改多个设置前先保存可用连接。
让Agent辅助时，要求比较成功的最小序列和失败请求，找第一处不支持的字段或顺序。实际调用按EvoLink模型页说明，不把含有效Key的排障聊天发送出去。
常见问题
Base URL是完整Chat Completions地址吗？
本自定义连接填到/v1，客户端补/chat/completions。
下拉菜单没有Gemini 4怎么办？
核对当前API模型ID，用文档支持的手填方式，再单独测试生成。
所有400都要删除末尾assistant消息吗？
不是，先看完整报错；model-turn判断只适用该签名，还需检查实际请求。
Google的Key能直接用于EvoLink吗？
按调用目的地使用凭据，本路径使用EvoLink Key。
打开缓存设置就会省钱吗？
不能保证，先核对供应商支持和本路由实际用量。
报错反馈应提供什么？
版本、路由模型、启用功能、脱敏错误与最小复现，不含凭据。
参考资料
- SillyTavern自定义连接与提示词转换。
- SillyTavern配置。
- EvoLink Chat Completions地址。
- EvoLink Gemini 4：模型与协议，核对日期为2026年10月16日。
