设置自定义模型

除了使用 Loomy 默认下发的模型外，你也可以接入第三方服务商的模型，自由配置 API Key、可用模型列表、模态以及 token 限制。本文以接入**智谱（BigModel）**为例，完整演示自定义模型的配置流程。所有配置信息均保存在本地，Loomy 不会上传或获取你的密钥数据。

1. 进入服务商配置页面

1. 点击应用左侧菜单栏的「设置」，选择「模型」进入模型配置页面。
2. 在页面顶部将标签页切换到「服务商配置」。

在这里你可以：

• 配置 Loomy 内置的默认服务商（如 DeepSeek、豆包、通义千问、智谱等）；
• 通过右上角的「+ 添加自定义服务商」接入任意兼容 OpenAI 协议的服务商。

2. 配置智谱服务商

以智谱为例，演示如何配置一个服务商。

2.1 填写 API Key

1. 在服务商列表中找到「智谱」卡片，点击右侧的「配置」按钮，进入服务商配置页面。
2. 前往 智谱开放平台 创建并复制 API Key。
3. 将 API Key 粘贴到对应的输入框中。

2.2 获取可用模型

大多数服务商都支持从 API 直接拉取模型列表：

• 在「可用模型」区域，点击「从 API 获取」按钮。
• 等待请求完成后，可用模型将自动填充到列表中（如 glm-4.6、cogview-4 等）。

如果服务商不支持自动获取，可以手动添加模型并填写模型 ID。

2.3 配置模型卡片

点击任一模型，打开其模型卡片，按需配置以下选项：

• 输入模态 / 输出模态：根据模型实际能力勾选。
  • 多模态模型建议勾选对应的输入模态（如 text、image、audio），以便完整发挥模型能力。
  • 生图模型（如智谱的 cogview 系列）需要将输出模态勾选为 image。
• Token 限制：建议显式配置，以充分利用模型上限。
  • 上下文窗口（Context Window）：模型支持的最大上下文长度。
  • 输出上限（Max Output Tokens）：单次生成的最大 token 数。
  • ⚠️ 一旦配置了上下文窗口，输出上限为必填项。

建议

完整配置模态与 token 限制，可以让 Loomy 在调度模型时获得更准确的能力画像，从而生成更稳定的对话与任务输出。

2.4 保存并应用

模型配置完成后，点击页面底部的「保存并应用」，配置即对当前服务商生效。

3. 启用自定义模型

回到模型配置页（「模型配置」标签）。默认情况下，Loomy 使用的是 Loomy 下发模型。要切换到刚刚配置的第三方模型：

1. 点击「模型配置」右上角的「启用自定义模型」开关。
2. 在出现的模型选择器中，选择你刚刚配置好的智谱模型（如 glm-4.6）。
3. 点击「保存」。

4. 配置默认生图模型

如果你在 2.3 中配置了生图模型（如智谱的 glm-image），可以将其指定为 Loomy 的默认生图模型，让对话中的 Loomy_image 工具直接调用它生成图像。

1. 在「模型配置」页面中，找到「默认生图模型」配置项。
2. 在下拉选择器中选择已经配置好的生图模型（确保该模型的输出模态已勾选 image）。
3. 点击「保存」。

配置完成后，在对话中触发 Loomy_image 工具（例如："帮我生成一张照片，一只可爱的小猫咪，坐在阳光明媚的窗台上，背景是蓝天白云"），Loomy 就会使用你指定的智谱生图模型生成图像。

提示

若下拉列表中找不到目标生图模型，请回到「服务商配置」页确认该模型的输出模态已勾选 image，否则不会出现在生图模型候选中。

5. 验证配置

返回对话界面，进行两项简单验证：

• 对话模型：向模型提问"你是什么模型？由哪家公司开发？"，确认其返回智谱 GLM 的身份信息。
• 生图模型：发送一条生图指令（如"画一只在月球上滑板的柴犬"），观察 Loomy_image 工具是否成功调用并返回图像。

两项均通过即说明自定义模型已配置成功。

常见问题

「从 API 获取」失败怎么办？

• 检查 API Key 是否正确、是否仍在有效期内；
• 确认网络可以正常访问该服务商的 API 域名；
• 如服务商不支持模型列表接口，可手动添加模型并填写模型 ID。

配置了上下文窗口但忘记填输出上限会怎样？

保存时会被拦截并提示补充。请填写一个合理的输出上限（参考服务商官方文档中的 max_tokens 限制）。

生图模型为什么没有图片输出？

请确认在模型卡片中将输出模态勾选为 image，仅勾选 text 的模型不会触发图像生成能力；同时确保已在「模型配置」中将该模型设置为默认生图模型。

切换模型需要重启应用吗？

不需要。保存配置后，返回对话界面即可立即生效。

如何获取 API Key？

不同的 AI 服务商获取 API Key 的方式不同，通常需要：

1. 访问对应服务商的官网
2. 注册账号并完成实名认证
3. 在控制台或开发者中心创建 API Key
4. 复制 API Key 并粘贴到 Loomy 的配置页面