[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72489":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":38,"readmeContent":39,"aiSummary":40,"trendingCount":16,"starSnapshotCount":16,"syncStatus":41,"lastSyncTime":42,"discoverSource":43},72489,"AIstudioProxyAPI","CJackHwang\u002FAIstudioProxyAPI","CJackHwang","FastAPI + Playwright + Camoufox 中间层代理服务器，兼容OpenAI API且支持参数转发。项目通过浏览器自动化将API请求转发到 Google AI Studio Chat，并同样按照OpenAI标准格式返回的工具。内置调试WebUI面板。","https:\u002F\u002Flinux.do\u002Fu\u002Fcjackhwang",null,"Python",2412,410,18,21,0,12,17,27,36,91.04,"GNU Affero General Public License v3.0",false,"main",true,[27,28,29,30,31,32,33,34,35,36,37],"api","camoufox","fastapi","google-ai-studio","middleware","openai","openai-api","playwright","proxy","python","reverse-proxy","2026-06-12 04:01:06","# AI Studio Proxy API\n\n将 Google AI Studio 网页界面转换为 OpenAI 兼容 API 的代理服务。通过 Camoufox + Playwright 自动化，提供稳定可控的 API 访问。\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=CJackHwang\u002FAIstudioProxyAPI&type=Date)](https:\u002F\u002Fwww.star-history.com\u002F#CJackHwang\u002FAIstudioProxyAPI&Date)\n\n---\n\n## 主要特性\n\n- **OpenAI 兼容 API**：支持 `\u002Fv1\u002Fchat\u002Fcompletions`、`\u002Fv1\u002Fmodels`\n- **函数调用三模式**：`auto` \u002F `native` \u002F `emulated`，支持失败回退\n- **认证轮转与 Cookie 刷新**：支持 profile 自动轮转、周期刷新与关停保存\n- **启动链路完整**：CLI 启动器、内置 Web UI、桌面 GUI 启动器\n- **现代化前端**：内置设置页、状态检查与日志能力\n- **CI\u002FCD 工作流**：PR 检查、Release、Upstream Sync\n\n## 系统要求\n\n| 组件 | 要求 | 推荐 |\n| --- | --- | --- |\n| Python | >=3.9, \u003C4.0 | 3.10+ \u002F 3.11+ |\n| 依赖管理 | Poetry | 最新版本 |\n| Node.js | 前端构建需要 | LTS |\n| 内存 | >=2GB | >=4GB |\n\n---\n\n## 🚀 快速开始\n\n### 1. 克隆并安装\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FCJackHwang\u002FAIstudioProxyAPI.git\ncd AIstudioProxyAPI\npoetry install --with dev\n```\n\n### 2. 配置环境\n\n```bash\ncp .env.example .env\n```\n\n建议先确认：`PORT`、`STREAM_PORT`、`UNIFIED_PROXY_CONFIG`、`LAUNCH_MODE`、`FUNCTION_CALLING_MODE`。\n\n### 3. 首次认证并启动\n\n```bash\n# 首次建议 debug，完成登录并保存 auth\npoetry run python launch_camoufox.py --debug\n\n# 日常建议 headless\npoetry run python launch_camoufox.py --headless\n```\n\n### 快速测试\n\n```bash\n# 健康检查\ncurl http:\u002F\u002F127.0.0.1:2048\u002Fhealth\n\n# 模型列表\ncurl http:\u002F\u002F127.0.0.1:2048\u002Fv1\u002Fmodels\n\n# 聊天请求\ncurl -X POST http:\u002F\u002F127.0.0.1:2048\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"model\":\"gemini-2.5-pro\",\"messages\":[{\"role\":\"user\",\"content\":\"你好\"}]}'\n```\n\n访问 `http:\u002F\u002F127.0.0.1:2048\u002F` 使用内置 Web UI。\n\n---\n\n## 系统架构\n\n```mermaid\ngraph TD\n    subgraph \"用户端\"\n        User[\"用户\"]\n        WebUI[\"Web UI\"]\n        APIClient[\"API 客户端\"]\n    end\n\n    subgraph \"启动与配置\"\n        Launcher[\"launch_camoufox.py\"]\n        Env[\".env 配置\"]\n    end\n\n    subgraph \"核心服务\"\n        FastAPI[\"FastAPI 应用\u003Cbr\u002F>api_utils\u002F\"]\n        BrowserOps[\"页面控制与自动化\u003Cbr\u002F>browser_utils\u002F\"]\n        StreamProxy[\"流式代理\u003Cbr\u002F>stream\u002F\"]\n    end\n\n    subgraph \"外部依赖\"\n        Camoufox[\"Camoufox 浏览器\"]\n        AIStudio[\"Google AI Studio\"]\n    end\n\n    User --> Launcher\n    Launcher --> Env\n    WebUI --> FastAPI\n    APIClient --> FastAPI\n    FastAPI --> BrowserOps\n    FastAPI --> StreamProxy\n    BrowserOps --> Camoufox --> AIStudio\n    StreamProxy --> AIStudio\n```\n\n---\n\n## 运行模式\n\n| 命令 | 说明 | 场景 |\n| --- | --- | --- |\n| `python launch_camoufox.py --headless` | 无头模式 | 日常使用、服务器 |\n| `python launch_camoufox.py --debug` | 调试模式 | 首次认证、故障排查 |\n| `python launch_camoufox.py --virtual-display` | 虚拟显示 | Linux 无 GUI 环境 |\n\n---\n\n## ⚙️ 配置\n\n项目使用 `.env` 统一配置管理：\n\n```bash\ncp .env.example .env\n```\n\n核心配置示例：\n\n| 配置 | 默认值 | 说明 |\n| --- | --- | --- |\n| `PORT` | `2048` | 主 API 端口 |\n| `STREAM_PORT` | `3120` | 流式代理端口（`0` 关闭） |\n| `UNIFIED_PROXY_CONFIG` | 空 | HTTP\u002FHTTPS 代理 |\n| `AUTO_ROTATE_AUTH_PROFILE` | `true` | 认证自动轮转 |\n| `FUNCTION_CALLING_MODE` | `auto` | 函数调用模式 |\n\n详细项见：[配置参考](docs\u002Fconfiguration-reference.md)\n\n> 说明：配置默认值以 `.env.example` 为准；少数配置存在代码兜底默认值，详见配置参考中的说明。\n\n---\n\n## 📚 文档\n\n- [文档总览](docs\u002FREADME.md)\n- [快速开始](docs\u002Fquick-start.md)\n- [部署与运维指南](docs\u002Fdeployment-and-operations.md)\n- [API 使用说明](docs\u002Fapi-usage.md)\n- [函数调用模式](docs\u002Ffunction-calling.md)\n- [认证轮转与 Cookie 刷新](docs\u002Fauth-rotation-cookie-refresh.md)\n- [排障指南](docs\u002Ftroubleshooting.md)\n- [开发、测试与发布](docs\u002Fdevelopment-and-release.md)\n- [多实例 Docker 管理器](scripts\u002Fmulti-instance-manager\u002FREADME.md)\n\n---\n\n## 客户端配置示例\n\n以 Open WebUI 为例：\n\n1. 进入设置 -> 连接\n2. API Base URL 填 `http:\u002F\u002F127.0.0.1:2048\u002Fv1`\n3. 若你未配置 API Keys，可留空或填任意字符；若已配置，请填写有效 Key\n4. 保存后即可对话\n\n---\n\n## 开发检查\n\n```bash\npoetry run ruff check .\npoetry run pyright\npoetry run pytest\n```\n\n前端构建：\n\n```bash\ncd static\u002Ffrontend\nnpm ci\nnpm run build\n```\n\n---\n\n## 致谢\n\n- **项目发起与主要开发**: [@CJackHwang](https:\u002F\u002Fgithub.com\u002FCJackHwang)\n- **核心维护**（架构重构、测试体系）: [@NikkeTryHard](https:\u002F\u002Fgithub.com\u002FNikkeTryHard)\n- **功能完善、页面操作优化**: [@ayuayue](https:\u002F\u002Fgithub.com\u002Fayuayue)\n- **实时流式功能优化**: [@luispater](https:\u002F\u002Fgithub.com\u002Fluispater)\n- **项目重构贡献**: [@yattin](https:\u002F\u002Fgithub.com\u002Fyattin)（Holt）\n- **下游维护分支致谢作者**: [@MasuRii](https:\u002F\u002Fgithub.com\u002FMasuRii)\n- **社区支持**: [Linux.do 社区](https:\u002F\u002Flinux.do\u002F)\n\n## License\n\n[AGPLv3](LICENSE)\n\n## 支持作者\n\n如果本项目对你有帮助，欢迎支持作者持续开发：\n\n![支持作者](.\u002F支持作者.jpg)\n","AI Studio Proxy API 是一个将 Google AI Studio 网页界面转换为 OpenAI 兼容 API 的中间层代理服务。该项目基于 FastAPI、Playwright 和 Camoufox 技术栈构建，能够通过浏览器自动化技术将 API 请求转发至 Google AI Studio，并以标准的 OpenAI 格式返回响应结果。支持多种函数调用模式、认证轮转及 Cookie 刷新等功能，确保了稳定性和可控性。内置调试 WebUI 面板，便于用户进行配置和状态监控。适用于需要在本地或服务器环境中访问 Google AI Studio 但希望使用 OpenAI API 接口的应用场景，尤其适合开发者测试和集成工作。",2,"2026-06-11 03:42:16","high_star"]