#OAuth 插件概述

除了常规的付费 API Key 外，很多开发者拥有 ChatGPT Plus/Pro、Claude Pro/Team、Cursor、GitHub Copilot 等平台的个人订阅或组织账号。

AIO Proxy 内置了强大的 OAuth 插件体系，允许直接登录并托管这些订阅账号，享受以下核心优势：

• 免手填 Key：支持通过浏览器一键登录或 CLI 设备码授权，Access Token 与 Refresh Token 由系统在底层自动安全加密存储与静默续期。
• 动态模型目录：账号成功连接后，插件会自动通过官方接口发现你当前订阅权限所能调用的全部模型。
• 配额监控与价值换算：实时采集账号的剩余请求限额、重置时间窗口，并按官方商业 API 定价自动折算“等效价值”。
• 自动熔断与无感回退：当某个账号配额耗尽（触发 429）或遇到限制时，AIO Proxy 会自动将流量故障切换至其他备用账号或 API 提供商。

#内置官方插件索引

点击下方卡片或侧边栏查看对应插件的详细使用教程：

#通用授权登录方式

AIO Proxy 支持两种便捷的 OAuth 账号接入方式：

#方式一：Dashboard 一键授权（推荐）

1. 打开控制台：http://127.0.0.1:9317/dashboard。
2. 进入 “提供商” 页面，点击 “添加提供商”。
3. 提供商类型选择 “OAuth 账号”，在下拉列表中选择对应的厂商。
4. 点击 “授权登录”，浏览器将弹出官方授权页面，按提示确认授权即可自动完成绑定。

#方式二：命令行交互式登录

在无图形界面终端或远程服务器操作时：

aio-proxy provider login

按终端指引选择目标提供商，通过终端打印的设备码链接在浏览器完成授权。

#配置文件结构

所有已授权的 OAuth 账号均在 config.jsonc 的 providers 中声明：

{
  "providers": {
    "my-account": {
      "kind": "oauth",
      "plugin": "@aio-proxy/plugin-openai-chatgpt",
      "capability": "default",
      "priority": 10,
      "weight": 100,
      // 可选：排除不想对外暴露的模型
      "excludedModels": ["text-davinci-002"],
      // 可选：模型别名映射
      "alias": {
        "gpt-5": "gpt-5",
      },
    },
  },
}

安全提示：OAuth 产生的 Access Token 与 Refresh Token 会由系统安全隔离存储在内部凭据库中，不会暴露在纯文本的 config.jsonc 中。