酒馆AI（SillyTavern）中文教程：接入Hojicha，免费获取API密钥和酒馆角色卡

打开账号页面创建API密钥。

Hojicha是Teasa温暖焙香、带一点小撩拨的对话风格。

需要用到的设置

服务器地址要按表格原样填写。SillyTavern会自己补全请求路径，不需要在末尾加/chat/completions。SillyTavern官方连接指南（英文）说明了Custom连接的各项设置。

1. 创建你的Teasa API密钥

登录Teasa账号，找到在SillyTavern中使用Teasa。给密钥起个名字，点击创建API密钥。密钥只会显示一次，趁它显示时复制下来并妥善保管；不要把它写进角色卡、截图或分享出去的预设文件里。

创建密钥本身不会增加额度。每个账号只能由Teasa管理员手动发放一次试用额度。你名下的所有密钥共享同一份余额，重新创建密钥不会重置额度。API额度和Teasa Pass、宝石、应用内对话是分开计算的。

2. 连接并选择Hojicha

在SillyTavern里打开API Connections，选择Chat Completion，再选Custom (OpenAI-compatible)。按表格填入服务器地址和密钥，连接后从模型列表里选择hojicha。已经填写chai的现有设置也能继续使用。

先从纯文字对话开始，上下文长度设为32,256，回复长度上限设为1,500。把工具调用、图片输入和结构化JSON输出都关闭。这次API试用只包含Hojicha；Matcha只在Teasa的应用内体验中提供，不在这次API试用范围内。

3. 酒馆角色卡下载：导入一个免费的入门角色

如月连经营着街角那家二手书店。 他只凭一句记得不太清楚的话，就能帮你找到一本书，但邀请对方"要不要多坐一会儿"这种事，似乎超出了他的专业训练范围。今晚他还剩最后一组展台没布置好，脑子里有两个完全不同的想法。

这是一个原创、非露骨的角色，为成年角色和成年玩家而写。你可以从安静的友谊开始，也可以在选书上和他争论几句，或者让恋爱慢慢在对话里发展起来。

下载连的英文版角色卡 Character Card V2

在Character Management里选择Import character，选中下载好的.json文件。打开连的对话，就能从他的开场白开始聊。JSON文件里包含他的角色设定、开场白和对话示例；肖像可以在SillyTavern里自行添加。

试试这句开场台词：

"有一个展台叫'让人失眠的书'，至少得有一本很惨的爱情故事。你会选哪一本？"

也可以婉拒他的邀请："我只能待五分钟。"他的角色设定里，有自己的喜好、书店之外的生活，也知道该怎么接受被拒绝。接下来这场戏由你的回应决定。

如果你已经有喜欢的角色卡，当然也可以直接用自己的。你还可以在Creator Studio里创建一个可复用的角色，打开导出到SillyTavern，下载JSON文件，或者一张嵌入了角色卡的PNG肖像。我们的角色卡写作指南能帮你打磨角色的声音、动机和一个值得回应的开场。

4. 确认第一条回复是否成功

发送一条消息，等待回复。然后到Teasa账号刷新Recent requests，查看状态、token用量和扣费情况。连接状态显示成功只是第一步，收到真正的回复才说明生成成功了。

想要一段有意思的第一次对话，可以先问问连关于这次展台的想法，反驳他的一个推荐，再决定要不要多留一会儿。你可以编辑角色卡，开一个新对话来比较不同的开场。每生成一次回复都会消耗试用额度。

排查连接、模型或上下文错误

推荐的上下文设置，是在模型32,768 token的窗口内，给Teasa的格式适配器留出了余量。角色设定、世界信息和历史记录都会占用这部分空间；如果长对话被拒绝，就再往下调一些。参见SillyTavern关于角色与上下文的说明（英文）。

如果问题仍未解决，请附上时间、报错内容和相关设置，联系Teasa支持（英文）。发送截图前，请去掉API密钥和私密对话内容。

试用额度与对话记录

试用额度按每百万输入token 0.05美元、每百万输出token 0.22美元计费。这次试用没有自动充值或付费续费。余额不足时，新的请求会停止。因中断或取消而没有拿到最终用量的请求，会按预留的最高额度计费，并标注为预估值。

提示词和回复会发送给我们的推理服务商，并按照你账号的对话保留设置留存，用于支持和质量审核。账号页面可以撤销密钥、删除API对话记录。SillyTavern自己的本地对话记录是单独保存的。发送任何个人信息之前，请先阅读隐私政策。

继续在Teasa里游玩

想体验可游玩的故事、任务、关系里程碑和角色私信，来Teasa探索一下。这些体验都在Teasa内运行；连接模型API并不会把它们带进SillyTavern。SillyTavern里的对话和Teasa的故事游玩记录是完全分开的。

在账号页面连接Hojicha，或阅读开源适配器指南（英文）了解更多API细节。

FAQ

我能用免费的Teasa API试用SillyTavern吗？

只有在Teasa管理员为你的账号发放过试用额度之后才可以。新账号的初始API额度是0美元，创建密钥本身不会激活免费试用。管理员可以为每个账号一次性发放1美元额度；没有自动扣费，也没有无限制的免费用量。

在SillyTavern里连接Teasa，要填什么地址和模型？

选择Chat Completion和Custom (OpenAI-compatible)，服务器地址填https://teasa.ai/model-api/v1，模型ID填hojicha，密钥用你在Teasa账号页面创建的那个。

这个API密钥能用Matcha吗？

这次试用只提供Hojicha。Matcha是Teasa应用内体验里的另一种聊天风格，这些API密钥无法使用。

酒馆角色卡在哪里下载？

本文提供了原创角色"如月连"（一位成年书店老板）的英文版酒馆角色卡，格式是Character Card V2 JSON文件。通过SillyTavern的Character Management导入即可。这张卡不含肖像，也不含API密钥。

这个API会把Teasa的记忆和任务也带进SillyTavern吗？

这个API只根据SillyTavern发来的角色设定和对话上下文生成回复。Teasa的故事任务、关系里程碑、已保存的玩家记忆和带检索的角色对话，都运行在Teasa内部，不会通过这个连接同步过去。