RisuAI 集成指南

概览

RisuAI 的 Custom Models 槽位允许你粘贴 Request URL、API 密钥和模型 ID。需要注意的是 Autofill Request URL 开关：开启时，RisuAI 会重写你粘贴的 URL，这会悄无声息地破坏连接。

快速配置

将以下三个值复制到 RisuAI Advanced Settings 的 Custom Models 字段中。

Request URL: https://api.unorouter.ai/v1/chat/completions
API 密钥:    YOUR_API_KEY
模型 ID:   claude-opus-4-5

请粘贴以 `/v1/chat/completions` 结尾的完整 URL。RisuAI 在 Custom Models 模式下没有模型下拉菜单，Model ID 是手动输入的文本字段。

逐步配置

1. 1
   打开 Advanced Settings

   在 RisuAI 中打开 Settings，再进入 Advanced Settings。

2. 2
   选择模型槽位

   点击 Chat Bot 模型选择器，滚动到模型列表底部，选择 Custom Models。

3. 3
   取消勾选 Autofill Request URL

   在粘贴任何内容之前，该开关必须为关闭状态。请参见上方的关键警告。

4. 4
   粘贴 Request URL

   粘贴以 `/v1/chat/completions` 结尾的完整 URL。

5. 5
   粘贴 API 密钥

   将你的 UnoRouter API 密钥粘贴到 API Key 字段。部分 RisuAI 构建将此字段命名为 Authorization；如果没有 API Key 字段，请使用该字段。

6. 6
   粘贴 Model ID

   从 UnoRouter 的模型页面复制或输入精确的模型名称。

7. 7
   保存

   关闭设置面板，RisuAI 会将配置写入浏览器本地存储。

8. 8
   发送测试消息

   打开任意聊天并发送测试消息以验证回复。

为什么 autofill 开关如此重要

Autofill Request URL 的初衷是防止在命名预设提供商上出现拼写错误。对于 Custom Models 而言，它反倒成了陷阱：RisuAI 会把你的自定义 URL 重写为并不指向我们的默认值。如果 RisuAI 更新后该开关被重新启用，请先回到步骤 3 再排查其他问题。

配置辅助模型

RisuAI 使用第二个模型槽位处理翻译、摘要和命名猜测等任务。请对 Auxiliary Model 选择器重复步骤 2 至 7，使用相同的 UnoRouter URL 和密钥。

故障排查

• 404 或 Invalid URL。 粘贴时 Autofill Request URL 处于开启状态，RisuAI 重写了 URL。请取消勾选该开关并重新粘贴 Request URL。
• 以前能用，现在没响应。 RisuAI 的一次更新可能会悄悄重新启用 Autofill Request URL。请打开 Custom Models 并确认它仍为关闭状态。
• 401 Unauthorized。 RisuAI 构建有时会同时暴露 API Key 和 Authorization 两个字段，不同版本只读取其中之一。请把密钥放到另一个字段再重试。
• 找不到模型。 Model ID 必须与模型名称完全一致。请从 UnoRouter 的模型页面复制粘贴，不要手动输入。
• 翻译或摘要功能失效。 辅助模型未配置。请为 Auxiliary Model 槽位重复一次配置。
• 流式输出被分块或内容缺失。 RisuAI 的 SSE 解析器期望纯 `data:` 事件。剥离该前缀的企业代理会导致流式输出混乱。如有可能，请在非企业网络下测试。
• 浏览器重启后设置丢失。 RisuAI 将配置存储在浏览器本地存储中，某些隐私模式会清除它。请在 Settings 中将配置导出到文件以作备份。