常用应用接入指南

模星球支持快速导入配置到多种 AI 应用，方便测试和日常使用。

支持的应用集成有三种方式：

• 应用预设一键导入配置
• API密钥一键导入配置
• 手动配置应用

使用前准备

1. 登录模星球，并在「API 密钥」页面创建一个密钥。
2. 确认密钥处于启用状态，额度充足，密钥状态未过期，并且当前 IP、分组和模型限制允许本次调用。

INFO

创建和使用API密钥的具体步骤请参阅API 密钥页面。

聊天预设一键导入配置

1. 点击左侧栏「聊天」展开平台已配置的聊天预设
2. 点击目标聊天预设
3. 浏览器会尝试在新窗口中启动已安装的外部应用
4. 系统自动跳转到目标应用并填充配置信息

INFO

Root 可以在「系统设置」 → 「控制台内容」 → 「聊天」维护管理聊天预设。

API密钥一键导入配置

1. 点击进入左侧栏「API 密钥」
2. 选中需要使用的API密钥
3. 在选中的密钥旁点击「 ... 」 → 「聊天」 → 「目标聊天应用」
4. 快速跳转至对应应用并使用选中密钥一键导入配置

手动配置聊天应用

对于不支持一键导入的应用，可以手动配置：

• 从 模星球 获取以下配置信息：
  

配置项	说明	获取位置
API Base URL	API 接口地址	模星球API地址，例如 https://api.moxingqiu.com/v1
API Key	API 密钥	API 密钥页面
可用模型	支持的模型列表	模型广场筛选查看密钥所在分组下的可用模型

• 通用配置步骤

1. 在目标应用中找到「设置」或「配置」入口
2. 找到「自定义 API」或「OpenAI 兼容接口」配置区域
3. 填写 API Base URL 和 API Key
4. 保存配置后即可使用

INFO

1. 大多数支持 OpenAI API 兼容接口的应用都可以通过填写自定义 API 地址的方式接入 模星球。
2. 如果应用要求完整端点，则使用 https://api.moxingqiu.com/v1/chat/completions ，看应用具体配置说明补充路径。
3. 目前已验证支持的AI应用列表及配置指南请参阅AI应用页面。

常见问题

• 侧边栏没有聊天预设：在「个人资料」→「左侧边栏个人设置」区域确认「聊天」模块已启用。
• 提示没有可用密钥：创建或启用 API 密钥，并检查额度、过期时间、模型限制和 IP 白名单。
• 桌面应用没有启动：先安装目标应用，并确认操作系统已注册对应的自定义协议；浏览器可能还会要求确认是否打开外部应用。
• 网页预设空白或拒绝加载：目标站点可能通过 CSP 或 X-Frame-Options 禁止 iframe。此时改用该应用的手动配置方式。
• FluentRead 连接后密钥无效：确认扩展已安装并在当前页面激活；当前版本可能存在密钥前缀兼容差异，仍失败时改用手动配置或其他预设。
• 请求返回未授权或禁止访问：检查认证头格式、模型名称、密钥状态、分组权限和 IP 限制；Claude、Gemini 请求还要确认使用了对应的路径和请求头。