AIStudioToAPI
一个服务把 AI Studio 变成三种通用大模型 API
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-11-10 · 当前星标 ★ 1866
使用教程
环境要求
- Node.js 与 npm 环境（README 全部流程使用 npm 脚本）
- 可正常登录的 Google 账号（用于 AI Studio 授权）
- 首次运行需联网下载 Camoufox 浏览器
- 磁盘可写目录用于保存认证文件（configs/auth）与统计数据（data）
安装与启动步骤
-
1克隆仓库
把项目源码拉到本地并进入目录，后续所有 npm 命令都在该目录执行。
git clone https://github.com/iBUHub/AIStudioToAPI.git cd AIStudioToAPI -
2运行认证脚本
脚本自动下载 Camoufox 浏览器并打开 AI Studio 引导手动登录，凭据保存在 configs/auth。
npm run setup-auth -
3复制环境变量文件
将根目录的 .env.example 复制为 .env，按需修改端口、API 密钥等配置，此步可选。
cp .env.example .env -
4启动服务
启动后 API 服务监听 7860 端口；已构建过前端资源时可用 npm run quick-start 快速重启。
npm start -
5打开控制台
浏览器访问本地地址进入 Web 控制台，可查看账号状态与服务状态。
-
6更新版本
已有本地部署时拉取最新代码、重装依赖并重启服务。
git pull npm install npm start
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
API_KEYS | 是 | 用于身份验证的有效 API 密钥列表，逗号分隔。 | your-api-key-1,your-api-key-2 |
PORT | 否 | API 服务器监听端口，默认 7860。 | 7860 |
HOST | 否 | 服务器监听的主机地址，默认 0.0.0.0。 | 0.0.0.0 |
WEB_CONSOLE_USERNAME | 否 | 网页控制台登录用户名，与密码同时设置时需输入两者。 | admin |
WEB_CONSOLE_PASSWORD | 否 | 网页控制台登录密码，仅设密码时登录只需密码。 | your-console-password |
TZ | 否 | 日志与显示使用的时区，默认跟随系统。 | Asia/Shanghai |
如何确认成功
浏览器打开 http://localhost:7860 ，能看到 Web 控制台主页并显示账号与服务状态，即启动成功。
常见问题
Q：Camoufox 浏览器下载失败怎么办？
A：可手动下载 Camoufox 可执行文件，并把环境变量 CAMOUFOX_EXECUTABLE_PATH 设为该文件路径，支持绝对和相对路径。
Q：直接运行时能在网页里用 VNC 添加账号吗？
A：不能。直接运行需用 npm run setup-auth 脚本添加账号，VNC 在线添加账号功能仅在 Docker 容器中可用。
Q：端口被占用如何修改？
A：在 .env 中修改 PORT 的值后重新启动服务，控制台访问地址中的端口也随之改变。
Q：不想每次都用脚本登录，有容器方案吗？
A：有。README 提供 Docker 命令与 Docker Compose 两种方式，挂载 auth 与 data 目录并设置 API_KEYS 即可。
Q：镜像拉取慢有替代地址吗？
A：可把镜像改为 Docker Hub 上的 ibuhub/aistudio-to-api:latest，README 中给出了该替代镜像。
注意事项
- 若前置反向代理，建议把端口映射改为 127.0.0.1:7860，避免直接对外暴露。
- 请求统计数据会持久化到 /data/usage-stats.jsonl（本地运行时对应项目下 data 目录）。
- 设置 SECURE_COOKIES=true 后控制台仅支持 HTTPS 访问。
- 日志排查可把 LOG_LEVEL 设为 DEBUG 查看详细输出。
核心亮点
- 同时兼容 OpenAI、Gemini、Anthropic 三套协议，现有 SDK 和客户端基本无需改代码
- 纯 JavaScript 实现，依赖少，克隆后配置凭据即可本地启动，上手成本低
- 支持流式响应，聊天前端和 Agent 框架可直接获得逐字输出体验
不足之处
- 依赖 Google AI Studio 的网页端接口，上游结构变动时封装层容易失效，稳定性受制于第三方
- 缺少请求限流、重试、多账号轮换等生产级能力，高并发或长时间运行场景需自行加固
适用场景
- 把 AI Studio 的模型接入只支持 OpenAI 协议的聊天客户端或 IDE 插件
- 在本地做多模型对比测试，用同一套调用代码切换不同后端
- 为自建 Agent 或自动化脚本提供统一的模型 API 入口
替代项目
LiteLLM、one-api、OpenAI-Forward
同类项目推荐
Atomic-Chat
开源
本地跑大模型，私密离线聊天，告别云端依赖
Local AI app and inference engine for agents. Run open-weight LLMs locally — privat···
matrixone
开源
一个库搞定事务、分析、向量与数据版本
AI-native HTAP database with Git-for-Data and built-in vector search, serving as the···
noronha
开源
用声明式管道搞定 ML 数据流程，快速上线模型
DataOps framework for Machine Learning projects.
llm-checker
开源
一条命令扫描硬件，告诉你本地能跑哪些大模型
Advanced CLI tool that scans your hardware and tells you exactly which LLM or sLLM m···
vllm-lens
开源
在 vLLM 推理中实时取激活、注入引导向量
Extract residual-stream activations and apply steering vectors (including activation···
gemini-business2api
开源
把 Gemini 商业版变成 OpenAI 接口，多账号负载均衡，还能生成图片视频。
OpenAI-compatible API for Gemini Business with multi-account load balancing and mult···
llama-cpp-docker
开源
一条命令在 Docker 里跑起 GPU 加速的本地大模型
Run llama.cpp in a GPU accelerated Docker container
dify-helm
开源
一条 helm install 把 Dify 全套 LLM 应用栈部署到 K8s
Deploy langgenious/dify, an LLM based app on kubernetes with helm chart.
gibram
开源
内存知识图谱，让 RAG 检索更懂关系
GibRAM is an in-memory knowledge graph server designed for retrieval augmented gener···