自带模型(BYOK)

Cordy 客户端与自部署网关的凭据和模型连接方式。

BYOK 表示由你选择提供商并提供访问凭据。云端请求仍会把内容发送给该提供商。本地推理是另一种选择,取决于所选运行时与模型。

谁负责请求认证?

产品连接与凭据归属
Chrome在扩展中配置云端提供商或本地模型。提供商凭据保存在扩展本地存储中;具体存储与权限边界见隐私指南
Desktop配置并登录你启动的 CLI 智能体。其支持的提供商、凭据、订阅和网络请求由该智能体负责。
Mobile配置兼容 OpenAI 的连接或 Anthropic 连接。API 密钥使用 Android Keystore 支持的存储或 iOS Keychain 实现;iOS 运行验证仍未完成。
Gateway运营者在服务器上保存上游渠道凭据,并用配置的 Fernet 密钥加密。客户端使用网关签发的 API 密钥,成员可使用该实例的账号与计费系统。

Chrome 与 Mobile 不要求中央 Cordy 账号。Gateway 部署有自己的账号与策略;CLI 智能体可能要求其自己的登录或订阅。直接向提供商付费和使用网关成员余额是不同的计费路径。

自定义端点

兼容 OpenAI 的端点通常通过基础 URL 提供 Chat Completions 与模型发现。兼容性需要覆盖你实际使用的操作:流式响应、模型 ID、工具、图片、推理参数和认证方式都可能不同。

请按具体产品的连接指南操作,不要假定任意端点都支持全部功能。Desktop 的兼容性由所选 CLI 决定。Mobile 支持两种提供商家族;添加兼容 OpenAI 的 URL 并不会新增一种原生协议适配器。

经由 Gateway 连接

兼容的客户端可以使用 Cordy Gateway 端点wnx_… 等网关密钥。运营者控制可用的公开模型 ID、权限、配额与成员余额。上游提供商凭据留在网关服务器上,请求先经过该服务器,再到达提供商。

当前 Gateway API 面向文本请求,不接受图片或音频输入。因此,文本对话连接可用并不代表 Chrome 或 Mobile 的多模态功能也能通过 Gateway 使用。支持范围见 API 参考