模型连接与参数
BYOK：密钥保存在本机安全存储；请求直连你配置的地址。
没有付费 API 时，可先看 免费云端；本机部署见 部署本地模型。
设置首页 AI 相关分为三个入口（文案以 App 为准）：
| 设置首页入口 | Hub 子项 | 作用 |
|---|---|---|
| 模型 | 模型连接、模型设置 | 对话 API 与全局采样 |
| 生图 | 生图连接、生图设置、关键词触发生图 | 出图 API、回复图片与规则 |
| 聊天设置 | 识图设置、聊天显示 | 图片描写、气泡显示等 |
单聊覆盖路径：聊天页 → 聊天设置 → 语言模型 / 生图模型 / 识图与显示（不改全局默认）。
模型连接
路径：设置 → 模型 → 模型连接
| 操作 | 说明 |
|---|---|
| 新建 | 平台、密钥、Base URL、模型 |
| 编辑 / 复制 / 删除 | 列表右侧菜单 |
| 设为默认 | 新对话默认使用 |
| 测连 | 保存前或编辑页「测试」。须选文本聊天模型；TTS / 生图专用 ID（如 Gemini *-tts）会报不支持文字对话，见 错误排错 · textOutputUnsupported |
平台类型（常见）
| 选项（文案以 App 为准） | 用途 |
|---|---|
| 各云厂商预设 | 自动填国内/国际站 Base URL |
| 自定义 (OpenAI 协议) | 本地 Ollama / LM Studio、兼容网关 |
| 自定义 Gemini / Anthropic | 对应协议端点 |
多站点 · 国际站
部分平台（如智谱、百炼等）支持中国站与国际站，密钥归属需与所选站点一致。
本地模型详见 连接 MiniTavern 与 工具总览。
模型设置（全局参数）
路径：设置 → 模型 → 模型设置
常见项（名称以 App 为准）：
- 记忆长度（历史条数相关）
- 回复令牌（max tokens，上限 128000；部分 Claude 场景不要设为 None）
- Temperature、Top-P / Top-K
- 是否流式输出
会话级覆盖
路径：对话页 → 聊天设置 → 语言模型
可为单聊指定连接与采样，不改全局默认。
识图（图片描写）
路径：设置 → 聊天设置 → 识图设置
单聊可在 聊天设置 → 识图与显示 跟随默认或单独覆盖（描写模型与提示词仍用全局）。
- 关闭「图片描写」：多模态直接把图送给模型（模型需支持视觉）。
- 开启：仅当当前聊天主模型不支持图片参数时生效——先由描写模型图转文（可与识人同一次请求），再发主模型；描写结果会缓存复用。主模型已支持视觉时仍多模态直传，此开关不拦截。
不支持图片的主模型 + 开启描写后的发送顺序：描写（+识人）→ 主聊天（若开了智能/关键词回复出图会附带生图提示词）→ 若回复带生图数据再旁路生图。
若报「当前模型不支持图片」，见 错误排错 · visionUnsupported。
生图（连接 / 回复图片 / 关键词）
路径：设置 → 生图 → 生图设置（回复图片在生图设置页内）
| 子页 | 说明 |
|---|---|
| 生图连接 | 添加与管理生图 API（设置 → 生图 → 生图连接） |
| 生图设置 | 尺寸/质量、生成数量（仅 /imagine）、增强/负面提示词；回复图片开关与触发方式 |
| 关键词触发生图 | 规则列表；需同时在生图设置里开启回复图片并选关键词模式 |
回复图片（在生图设置里）：先打开开关，再选触发方式。关闭后聊天不会自动出图（斜杠命令、附件菜单、长按气泡不受影响）
- 智能判断：由模型根据对话判断这一轮要不要出图；画幅按场景选（手机自拍 3:4，相机成片 3:2），命中后固定 1 张。可附图发送作风格参考
- 关键词触发：用户消息命中关键词规则时出图；画面和画幅按当前对话生成，命中后 1 张
聊天里生图：
| 入口 | 说明 |
|---|---|
/imagine 提示词 | 先经主聊天模型判断：是否与当前对话有关、要不要角色/用户参考图，再拼提示词去生图。可先点加号附图。张数用生图设置里的「生成数量」。失败时气泡会留下并显示重试 |
/imagine scene / 附件 → 根据故事 | 按近期对话画当前这一幕，1 张 |
/imagine last / 附件 → 根据最后消息 | 按最后一条消息来画，1 张 |
未配置生图连接时，附件菜单四种生图模式与发送 /imagine 会弹出「去设置 / 取消」，不清空输入框。智能 / 关键词自动出图则为 Toast。在生图设置开启「回复图片」时若无连接会弹窗，开关保持关闭。
| 附件 → 生成背景图 | 画环境背景，1 张；完成后可设为聊天背景 | | 长按气泡 → 生图 | 按这条气泡来画，1 张 |
例子：输入「给我一张你的自拍照」会带上角色参考和对话语境；「给我一张小狗的照片」则按独立请求画，不套角色脸。
本机 A1111 / ComfyUI：生图模型部署 · 连 App。
云端免费档见 免费云端 · 生图。
排错入口
测连或聊天失败 → Toast / 气泡 → 查看详情（错误代码 + 原因 + 建议）→ 对照 错误代码排错。