[Feature Request] 支持 OAuth 账号级别的模型 alias（模型别名按 OAuth 账户控制）

[sillypy]

背景与需求

场景：openclaw/PromptClaw 或通用 OpenAI Responses 协议客户端通过 CLIProxyAPI 联调 Gemini 多账户时，存在以下问题：

• 目前的 oauth-model-alias 只能按渠道配置（如 gemini-cli），所有关联该渠道的账户共享同一组模型别名，无法独立区分不同 OAuth 登录（账号）的模型别名。
• 在 responses 场景下（如 OpenAI compatible responses 协议），客户端会和后端维持长连接、sticky session，不适合请求过程中频繁在不同账号间切换同名模型（如轮询 gemini-3-flash a和b 两个账号），因为不同账号句柄的 Token 可能不同，容易打乱流控或触发会话错误。
• 即便某个账号的 gemini-3-flash 额度耗尽，我也希望优先 fallback 到同一账号下的其他模型（如 2.5flash、pro），而不是优先在其它账号下继续轮询 gemini-3-flash。

期望行为

• 支持在配置/管理层级为每一个 OAuth 登录账户（如通过 auth.ID 或更细身份标识）配置模型别名（alias）映射。
• 允许客户端在请求时明确指定希望用哪一个账号的模型别名。例如，可以配置：
  • gemini-3-flash-a → a账号的 gemini-3-flash
  • gemini-3-flash-b → b账号的 gemini-3-flash
• 按 alias 请求时，后端能够映射到特定 OAuth 账号的目标模型，而不是在所有账号间轮询或混合分配。
• 当该账号的该模型不可用时，可以 fallback 到该账号其余模型，避免自动切换到其他账号同名模型。

建议实现方向

1. 在配置文件和控制 API 设计上支持按照 auth.ID 或唯一 OAuth 账户区分模型 alias。
2. 调度/模型路由时，增加判断模型别名与账号绑定关系。
3. （可选）兼容 responses/OpenAI 长连接场景下对 sticky-session 的需求。

参考用例

• openclaw/prompts 或自定义 responses 机器希望调度模型时精确控制使用哪个 OAuth 账户，不希望因 alias 冲突导致频繁切换账号

---

文档建议（当前可行的实践方案）

对于需要把不同 OAuth 账户的会话、额度、流控进行完全隔离的场景，目前推荐部署多个 CLIProxyAPI 实例，每个实例登陆一个独立 OAuth 账号，并通过不同 baseurl 区分路由。

示例：

• proxy-a:8000 → 仅账号 a
• proxy-b:8001 → 仅账号 b

这样可以做到 Responses、OpenAI compatibility 场景下长连接真正 sticky 到指定账号，不存在跨账号 fallback 和 quota 污染问题。

适用场景：账户数不多（通常 ≤5）。

不足：

• 随账号数量线性增长运维成本
• 监控、升级、apikey 管理需单独操作每个实例

社区建议：如需单实例多账号可控路由，欢迎跟进本 issue 或补充用例，推动 CLIProxyAPI 增加账号级别路由和约束能力。

---

未来改进方向

为了支持单实例多账户的精细化路由控制，建议 CLIProxyAPI 添加：

1. API Key ↔ OAuth 账户绑定：允许为每个 api key 配置允许使用的 OAuth 账户 ID 白名单
2. per-account 模型别名：在 oauth-model-alias 基础上支持按 auth.ID 配置别名
3. 请求时账户约束：通过请求头（如 X-Auth-ID）显式指定使用哪个账户

这样可以在单实例内部实现账户级别的隔离和路由，大幅降低多账户场景的运维复杂度。

---

相关用例：

• openclaw/PromptClaw 或其他 Responses API 客户端需要为不同用户 sticky 到不同 OAuth 账户
• 企业内多部门共用一套 CLIProxyAPI，但每个部门对应独立的 Gemini/Claude/ChatGPT 账号

[luispater]

这个需求可以使用prefix字段完成，oauth文件中支持增加prefix字段，请求时使用prefix/model来请求。

比如：

{"type":"codex", "prefix":"department1"}

则你可以使用 department1/gpt-5.4 来调用模型指定凭证的gpt-5.4，并且相同的prefix仍然可以轮询

[sillypy]

感谢，搞定了