Chub / Venus 集成指南

概览

Chub 的 Secrets 面板接受完整的 `/v1/chat/completions` URL 以及你的 API 密钥。在 Prompt Structure 中选择模型之前，Check your proxy 按钮会验证连接。

快速配置

将以下两个值复制到 Chub Secrets 面板的 Reverse proxy 字段中。

URL: https://api.unorouter.ai/v1/chat/completions
密钥: YOUR_API_KEY

请粘贴以 `/v1/chat/completions` 结尾的完整 URL。Chub 要求提供完整路径，不要只粘贴基础 URL。

逐步配置

1. 1
   打开 Secrets 面板

   点击 Chub 右上角的汉堡菜单，然后选择 Secrets。

2. 2
   展开 OpenAI

   点击 OpenAI 区块将其展开。

3. 3
   滚动到 Reverse proxy

   Reverse proxy 子区块包含 URL 和 Key 字段，以及 Check your proxy 按钮。

4. 4
   粘贴 URL 和密钥

   URL 以 `/v1/chat/completions` 结尾，Key 为你的 UnoRouter API 密钥。

5. 5
   点击 Check your proxy

   等待绿色确认。如果失败，请重新检查 URL 并重新粘贴密钥。

6. 6
   打开 Configuration

   返回汉堡菜单，选择 Configuration，再进入 Prompt Structure。

7. 7
   选择 OpenAI 和模型

   将 API 下拉菜单设置为 OpenAI，然后从模型下拉菜单中选择目标模型。

模型下拉菜单需要代理检查通过

Chub 只在代理检查成功后才会填充 Prompt Structure 中的模型下拉菜单。如果下拉菜单为空，请返回 Secrets → OpenAI → Reverse proxy 重新执行 Check your proxy。

故障排查

• Check your proxy 按钮验证失败。 URL 不正确。它必须以 `/v1/chat/completions` 结尾，仅提供基础 URL 无法通过。
• 模型下拉菜单为空。 代理检查尚未通过。请重新执行步骤 5，等待绿色状态出现。
• 回复为空。 Prompt Structure 中选择了错误的 API。请打开 Configuration → Prompt Structure，将 API 下拉菜单切换为 OpenAI。
• 401 Unauthorized。 你的 API 密钥已轮换或有拼写错误。请在 UnoRouter 控制台生成新密钥，然后重新粘贴到 Reverse proxy。
• 出现上下文长度警告。 请在 Prompt Structure 中降低最大上下文长度，或在 UnoRouter 的模型页面选择一个上下文更大的模型。
• 重新加载后代理检查显示通过，但消息仍失败。 Chub 会跨会话缓存代理检查状态。请在新会话中再点击一次 Check your proxy，强制重新检查。