Partner OAuth 接入

Beta。 OAuth 模式正在灰度开放，请联系我们登记你的应用。

如果你已经把 ofox 集成进自己的产品，用户可以通过一个 OAuth 按钮完成授权，全程不离开你的应用。通过这种方式注册的新用户会自动计入你的 partner 渠道 —— 与他们通过你的推广链接注册完全等效。

如何接入

联系我们登记你的应用。
我们为你创建 OAuth 应用，并绑定到你的推广渠道。
在你的产品里按标准 OAuth 2.1 流程接入授权按钮。

除标准 OAuth 流程外，你这边不需要任何额外配置 —— 没有额外参数、没有 URL 格式约定、没有 SDK。渠道映射由我们在服务端配置。

哪些消耗会被计入

仅限新注册用户。 当一个还没有 ofox 账号的用户点击你的 OAuth 按钮，他会被带到 ofox 登录页，切换到注册流程并完成注册 —— 绑定在注册那一刻建立。此后他的充值与消费都走正常的 partner 返佣结算。

已有 ofox 账号的用户，其归属永不改变。 授权你的应用不会改变它 —— 即使该用户从未被任何 partner 绑定过也一样。这既适用于已绑定其他 partner 的用户，也适用于完全没有绑定的用户。

这是刻意设计：推广绑定对一个账号是终身且排他的。允许改绑等于让一个 partner 抢走另一个 partner 拉来的用户。

首次调用的 scope

刚注册完拿到的 access token，可能还不包含 llm.invoke。

llm.invoke 只发给邮箱已验证的用户。而注册完成那一刻邮箱是否已验证，取决于用户选了哪种注册方式：

注册方式	完成时邮箱是否已验证	首个 token 里有无 `llm.invoke`
免密登录链接	是 —— 点开链接本身就是验证	有
邮箱 + 密码	否	被剔除，直到验证完成

scope 被剔除时 token 请求仍会成功 —— 响应里的 scope 字段列出的是实际发放的集合（RFC 6749 §3.3）。请读这个字段，不要假设申请什么就拿到什么。 没有 llm.invoke 去调 LLM API 会返回 403 insufficient_scope。

用户完成邮箱验证后，重新获取（或刷新）token，llm.invoke 就会包含在内。

返佣

被归因的用户按标准分层返佣结算（最高 9%），依据实际 API 用量计算。满 $50 起提，按月结算。当前条款见 Partner 页面。