文档中心阅读博客
文档中心合作伙伴指南

合作伙伴快速开始:让账号成为可用供给

按权限、Partner Key、账号、定价、运行保护和投放范围逐步准备供号。

先理解“导入”和“供号”的区别

导入账号只表示它已经接入系统。要被用户请求选中,还需要有效授权、可用额度、允许的模型、符合条件的价格与运行保护,以及 参与调度 + 官方市场或私有渠道。

因此,账号在列表里并不等于用户一定能调用。请按下面顺序设置。

1. 确认角色与 Partner Key

网站要能打开“合作伙伴控制台”。没有入口时,先向运营方申请相应权限。进入其中的“合作伙伴 API Key”,创建并复制 Key,再登录 Partner Client。

Partner Key 与用户调用模型的 Key 分开;不能把它直接填进编码工具当成消费端 Key。详见合作伙伴密钥。

2. 选择账号接入方式

接入方式谁维护上游登录适合场景
售卖本机账号官方 Codex/Claude Code 客户端续期,Partner 同步更新的访问凭证本机已经登录官方 CLI
授权/导入托管账号按账号类型由系统托管维护需要授权上传的供给账号

本机同步必须由对应客户端出口或配置代理处理,断线不会自动切到 Worker 出口。托管账号另有出口选择,详见托管账号接入。

Partner Client 账号列表

3. 配置价格和运行保护

在网站的合作伙伴控制台设置售卖模型及倍率,或者按渠道和订阅等级设置覆盖策略。再设置最大并发、额度预留等运行保护,防止供号过度消耗账号资源。

定价负责“卖什么、多少钱”;运行保护负责“什么时候停止接单”。两者分别保存。见供号、定价与出口。

4. 明确投放范围并开启调度

决定加入官方市场、一个或多个私有渠道,或者两者兼有;然后开启“参与调度”。

开启调度且加入供给范围后,存在 5 分钟最低在线约束:在期限内不能关闭调度、撤销供给范围或删除。只开启调度、没有加入任何范围时,不受这个供号约束。

5. 检查可用状态

查看账号的授权、额度、Worker 凭据状态和可用状态。进入“最近失败”检查错误;授权过期、出口离线、额度不足或命中保护都可能让账号暂时无法供号。

额度单元里的查询和重置是不同操作。第一次只查询,不要为了看看效果消耗重置卡。

6. 看真实收益

请求完成并结算后,到网站的合作伙伴收益记录查看对应请求、结算基数、平台费用和净收益。确认钱包入账,再考虑提现。没有请求被路由到该账号时,不会因“开启开关”自动产生收入。

继续阅读账号健康和收益与提现。