⚡ 通用配置与一键导入
掌握三类客户端连接接入方式:聊天预设一键导入、API 密钥快捷呼起与通用参数手动配置。
平台支持将 API 密钥与端点快速导入或配置到多种主流 AI 聊天客户端,方便测试和日常高频使用。
客户端集成方式
集成第三方 AI 客户端通常有三种方式:
- 聊天预设一键导入
- API 密钥一键呼起导入
- 手动复制配置参数
使用前准备
- 登录控制台,进入「API 密钥」管理页,创建一个专属密钥。
- 确认密钥处于启用状态且额度充足,且未受模型白名单或 IP 限制影响。
创建和管理 API 密钥的具体说明请参阅 API 密钥 页面。
方式一:聊天预设一键导入
- 点击左侧栏「聊天」展开已预置的主流聊天应用列表。
- 点击目标聊天客户端(如 Cherry Studio、NextChat、AQBot 等)。
- 浏览器将提示唤起本地已安装的对应客户端软件。
- 系统将自动向客户端注入 Base URL 与凭证参数,完成即开即用。
方式二:API 密钥一键呼起导入
- 进入左侧栏「API 密钥」页面。
- 在目标密钥右侧操作菜单点击「...」 → 「聊天」 → 选择目标应用。
- 浏览器将携带当前密钥直接唤起本地客户端,免去手动复制粘贴的繁琐步骤。
方式三:手动配置通用应用
对于未内置一键协议的应用,可以通过通用手动配置接入:
| 配置项 | 填写说明 | 获取来源 |
|---|---|---|
| API Base URL | 填入 https://api.openrely.ai/v1 | 平台首页或控制台概览 |
| API Key | 填入平台颁发的 sk- 格式密钥 | API 密钥 |
| 模型名称 | 填入标准 Model ID(如 gpt, claude 等) | 模型广场 |
通用配置步骤
- 打开第三方 AI 客户端的「设置」或「模型提供商(Providers)」。
- 选择「OpenAI」或「自定义 OpenAI 兼容接口」。
- 填入上述 Base URL 与 API Key。
- 点击拉取模型列表或保存配置,即可开启对话。
目前官方验证兼容的热门 AI Coding 与对话应用(如 Claude Code、Cursor、Cline、NextChat、Cherry Studio、AQBot 等)的专属配置图文教程,请查阅 AI 应用接入专区。
常见问题与排障
- 点击没有启动桌面客户端:请确保本地已预先安装并至少运行过一次该桌面客户端,以使操作系统成功注册对应 URL Scheme 协议。
- 提示没有可用密钥:请先在「API 密钥」页创建密钥,并确认余额或订阅未欠费。
- 请求返回 401 Unauthorized:检查客户端中填写的 API Key 是否包含多余空格,或密钥是否已被禁用/删除。
- 请求返回 404 Model Not Found:确认请求的模型名称与平台模型广场中支持的 Model ID 一致,并确认密钥未设置限制排除了该模型。
这篇文档对您有帮助吗?