AIStudio2API
将AI Studio Playground和Build反代成API | AI Studio to OpenAI, Anthropic & Gemini Compatible API
- 1.1k
- Go
- MIT
- 11 h ago
将 Google Gemini Web 转换为 OpenAI、Claude 和 Gemini 兼容 API
Repo Mag1cFall/Gemini-Web2API, read from GitHub 2 h ago. Mag1cFall has not joined Take My Repo.
Mag1cFall/Gemini-Web2API is a public repo on GitHub by Mag1cFall. 将 Google Gemini Web 转换为 OpenAI、Claude 和 Gemini 兼容 API. It declares the MIT license on GitHub. It is written mainly in Go, has 144 stars and last changed on 2026-11-21. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-21.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
将 Google Gemini Web 网页版转换为 OpenAI、Claude 和 Gemini 兼容 API。
![]() 概览 服务状态与接入 |
![]() 日志 请求与速度 |
![]() 用量 请求与费用 |
![]() 账号 状态与用量 |
![]() 设置 页面改配置 |
![]() API 试用 四种协议发请求 |
/v1/chat/completions、/v1/completions、/v1/responses、/v1/files、/v1/audio/*、/v1/videos、/v1/models/v1/messages、Files API/v1beta/models/{model}:generateContent、:streamGenerateContent、:predictLongRunning、Files API(high)、(low)、(-1) 等后缀或 @think=high 指定思考强度response_format、Anthropic output_format、Gemini responseSchema 与 responseFormat(含 text/x.enum 枚举)按 JSON Schema 约束回答gemini-3.5-flash-lite,不含官网工具与附件上传),账号就绪后优先使用账号gem-<Gem ID> 模型 ID 提供| 模型 ID | 名称 | 官网说明 / 能力 | 输入窗口 | 默认 |
|---|---|---|---|---|
gemini-4-hydrogen |
4 Hydrogen | All-around help | 32,768–1,048,576 | 是 |
gemini-3.5-flash-lite |
3.5 Flash-Lite | Quick answers | 32,768–1,048,576 | |
gemini-4-carbon |
4 Carbon | Most complex work | 32,768–1,048,576 | |
gemini-4-argon |
4 Argon | Code & analysis | 32,768–1,048,576 | |
gemini-auto |
Auto | Adapts to your needs(免费账号) | 32,768 | |
gemini-4-hydrogen-task、gemini-4-carbon-task、gemini-4-argon-task |
Task | 代为执行任务 | ||
gemini-default |
Default | 各账号的官方默认模型 | ||
gemini-3.1-flash-image |
Nano Banana 2 | 图片生成与编辑 | ||
gemini-video |
Video | 视频生成 | ||
gemini-music |
Music | 音乐生成 | ||
gemini-canvas |
Canvas | 文档与代码 | ||
gemini-deep-research |
Deep Research | 研究报告 | ||
gemini-guided-learning |
Guided Learning | 引导式学习 |
/v1/models 为准;模型 ID 由官网菜单的型号名生成,官网的用途说明作为 description,账号收到新模型后自动公开;模型 ID 可带 models/ 或 google/ 前缀/v1/models 以 alias_of 写明旧 ID 的去向;改名记录保存在 data/requests.db,重启后仍然有效,MODEL_MAPPING、MODEL_ACCOUNTS 与 FIRST_EVENT_HEDGE_MODELS 中的旧 ID 同样生效available_account_count 是可用账号数,default 标出默认模型,thinking_levels 列出可选思考强度/v1/images/*,size 与 imageConfig.aspectRatio 支持 1:1、9:16、3:4、4:3、16:9、2:3、21:9、1:8、8:1imageConfig.aspectRatio 支持横向 16:9 与竖向 9:16sudo apt install libwebkit2gtk-4.1-0,Ubuntu 24.04、Debian 12 及更新的桌面系统自带从 Releases 下载 windows-amd64.zip 发布包,解压后双击 gemini-web2api.exe:
gemini-web2api.exe 唤回已运行的窗口.env、auth/ 与 data/ 都在 gemini-web2api.exe 所在目录在 cmd 或 PowerShell 中运行命令时写作 cmd /c start /wait gemini-web2api.exe <参数>,命令行等程序结束后返回:
cmd /c start /wait gemini-web2api.exe --help cmd /c start /wait gemini-web2api.exe setup --email "name@example.com"
从 Releases 下载对应系统的桌面版:
| 系统 | 下载 | 数据目录 |
|---|---|---|
| macOS | desktop-…-darwin-universal.tar.gz |
~/Library/Application Support/Gemini-Web2API |
| Linux | desktop-…-linux-amd64.tar.gz 或 desktop-…-linux-arm64.tar.gz |
~/.config/Gemini-Web2API |
Gemini-Web2API.app;Linux 解压后运行 gemini-web2api,Ubuntu 22.04 先安装 libwebkit2gtk-4.1-0xattr -dr com.apple.quarantine Gemini-Web2API.app 后再打开.env、auth/ 与 data/ 都在上表的数据目录中先构建管理端前端,再编译程序:
pnpm -C web install pnpm -C web build go build -tags nomsgpack -o gemini-web2api.exe ./cmd/gemini-web2api
Windows 首次使用时,直接运行交互式配置:
.\gemini-web2api.exe setupsetup 会扫描本机 Chrome 账号,并短暂启动独立临时 Chrome 进程读取 App-Bound 主密钥。现有 Chrome 窗口与 Profile 保持原状。
也可以直接指定 Chrome 中已登录的账号;同一 Profile 登录了多个 Google 账号时,每个账号单独列出、单独导入:
.\gemini-web2api.exe setup --email "name@example.com"
也可以粘贴浏览器请求头中 Cookie 字段的一行值;这种状态在现有 Cookie 有效期内使用,不具备 OAuth 续签能力:
.\gemini-web2api.exe setup --cookie "SAPISID=...; __Secure-1PSID=..." --id account-name
浏览器扩展导出的 Cookie JSON 与 Netscape cookies.txt 文件用 --cookie-file 导入:
.\gemini-web2api.exe setup --cookie-file cookies.txt --id account-name
Cookie 来自登录了多个 Google 账号的浏览器时,用 --authuser 指定要使用的账号,取值为官网地址 gemini.google.com/u/N/app 中的 N,默认 0;管理端 Cookie 导入在粘贴后自动列出其中登录的账号:
.\gemini-web2api.exe setup --cookie-file cookies.txt --id account-name --authuser 1
服务部署在没有 Chrome 的服务器上时,在管理端“导入账号”页生成配对令牌,然后在登录了 Chrome 的电脑上把账号上传到服务器;令牌从标准输入读取,非本机地址需要 HTTPS,可经 SSH 隧道 ssh -L 8007:127.0.0.1:8007 <服务器> 使用 http://127.0.0.1:8007。Chrome 导入的账号上传后,setup --remote 留在源电脑按时续签并上传新会话,关闭窗口后可用 setup --remote <地址> --renew 恢复续签:
.\gemini-web2api.exe setup --email "name@example.com" --remote https://example.com
setup 会生成 auth/<账号>/storage-state.json 并验证模型目录。Chrome 导入还会保存浏览器退出后续签所需的 OAuth 续签材料与设备绑定会话参数。服务已在运行时,账号从管理端“导入账号”页导入;setup 要写入的 auth 目录正被运行中的服务使用时,setup 退出并给出提示。日常启动只需运行:
.\gemini-web2api.exe默认读取 auth 目录并监听 127.0.0.1:8007。Linux 和 macOS 可以使用已经生成的 auth 目录:storage-state.json 带 wrappedBindingKey(续签材料绑定在原设备上)的账号在现有 Cookie 有效期内使用,可由原 Windows 设备经 setup --remote 持续续签;其余 Chrome 导入的账号在任何系统上自动续签。
服务运行期间每 10 分钟为每个账号轮换一次登录 Cookie,与 Gemini 网页相同,并在设备绑定 Cookie 到期前用本机设备密钥刷新 Chrome 导入账号的设备绑定会话;响应中变化的 Cookie 写回 auth/<账号>/storage-state.json,重启后直接沿用。Chrome 导入的账号在登录态失效时自动续签。
程序启动时自动读取当前目录的 .env,setup 与日常服务使用同一个 PROXY。默认配置可以直接使用;需要调整时参照仓库中的 .env.example 编写 .env。
# 默认使用 Gemini Temporary Chat,不写入官网历史记录 GEMINI_SAVE_HISTORY=false # 本地 2API 访问密钥,多个 key 用逗号分隔 PROXY_API_KEY= # 代理池,多个代理用逗号分隔,支持 HTTP、HTTPS、SOCKS4、SOCKS5 PROXY=
docker compose up -d
docker-compose.yml 使用 ghcr.io/mag1cfall/gemini-web2api:latest,数据目录挂载到 ./data,其中放 .env、auth/ 与请求账本PROXY_API_KEY;从容器外打开管理端需要 ADMIN_AUTH_ENABLED=true 与 ADMIN_PASSWORDauth/<账号>/ 复制到 data/auth/data/.env 后执行 docker compose restart;写在 docker-compose.yml 的 environment 中的配置项由容器环境决定,设置页中对应的项不可修改docker-compose.yml 的 environment 中加 TZ: Asia/Shanghai 这样的时区名PROXY 是代理池,多个代理用逗号分隔,例如 PROXY=socks5://127.0.0.1:1080,http://user:pass@10.0.0.2:7890,支持 http、https、socks4、socks4a、socks5、socks5h。管理端“设置 → 服务 → 出口代理”按行编辑,保存后生效。
PROXY 为空时使用环境变量 HTTPS_PROXY,未设置时在 Windows 上使用系统代理设置(按协议分列时依次取 https、http 与 socks,socks 为 SOCKS4),都没有时直连账号也可以设置固定代理,固定代理优先于代理池,填 direct 表示该账号直连。在管理端账号页“修改代理”中填写,或在导入时指定:
.\gemini-web2api.exe setup --email "name@example.com" --proxy "socks5://127.0.0.1:1080"
setup --proxy 与管理端导入时填写的代理写入账号认证文件 auth/<账号>/storage-state.json 的 geminiWeb2api.proxy;不填时导入请求经 PROXY 中的一个代理发出,账号运行时从代理池分配。代理出口需要位于 Gemini 支持的地区。
POST /v1/chat/completions
POST /v1/completions
POST /v1/responses
GET /v1/responses/{id}
DELETE /v1/responses/{id}
GET /v1/responses/{id}/input_items
POST /v1/responses/{id}/cancel
POST /v1/responses/input_tokens
POST /v1/responses/compact
POST /v1/images/generations
POST /v1/images/edits
POST /v1/audio/speech
POST /v1/audio/transcriptions
POST /v1/audio/translations
POST /v1/videos
GET /v1/videos
GET /v1/videos/{id}
GET /v1/videos/{id}/content
DELETE /v1/videos/{id}
POST /v1/videos/{id}/remix
POST /v1/videos/extensions
POST /v1/files
GET /v1/files
GET /v1/files/{id}
GET /v1/files/{id}/content
DELETE /v1/files/{id}
GET /v1/models
data/requests.db 30 天,可读取、列出输入与删除,store: false 不保存;background: true 立即返回 queued,之后轮询或取消previous_response_id 由已保存的响应链补全前文,指向的响应没有保存时返回 404,conversation 由该 ID 已保存的响应补全前文,没有已保存的响应时开始新对话;其余续接字段(Chat、Anthropic 与 Gemini 的 previous_response_id 与会话 ID、X-Conversation-ID 请求头)返回 400。GEMINI_CONTINUE_SESSION=true(实验性)时多轮对话续接上一轮所在的网页会话,只发送新消息,响应带会话 ID:previous_response_id 与会话 ID 在服务重启后的 SESSION_TTL 内仍可续接,每轮发送完整历史的客户端在历史与上一轮回答一致时续接同一网页会话data/files/,生成请求以 file_id 引用;expires_after 按 OpenAI 规则设置到期时间,purpose=batch 的文件默认 30 天后删除;文件总量超过 4 GiB 时从最早的文件起删除/v1/audio/speech 使用官网回答的朗读功能,输出 mp3、opus、wav、flac 或 pcm,voice 与 speed 不生效/v1/videos 使用 gemini-video,JSON 请求的 input_reference(image_url 或 file_id)作为首帧;生成的视频与缩略图保存 48 小时,视频对象的 expires_at 为到期时间;remix 与 extensions 在本服务生成的已完成视频的网页会话中继续生成,extensions 的成品是拼接后的完整视频,seconds 为实际时长model_not_foundPOST /v1/messages
POST /v1/messages/count_tokens
POST /v1/files
GET /v1/files
GET /v1/files/{id}
DELETE /v1/files/{id}
GET /v1/models
带 anthropic-version 或 anthropic-beta 请求头的 /v1/files 请求按 Anthropic Files API 返回,消息中以 source.file_id 引用。
/v1/messages 支持 context_management 的 clear_tool_uses_20250919、clear_thinking_20251015 与 compact_20260112;压缩时由同一模型生成摘要并替换全部历史。
POST /v1beta/models/{model}:generateContent
POST /v1beta/models/{model}:streamGenerateContent?alt=sse
POST /v1beta/models/{model}:countTokens
POST /v1beta/models/{model}:predictLongRunning
GET /v1beta/operations/{id}
POST /v1beta/interactions
GET /v1beta/interactions/{id}
DELETE /v1beta/interactions/{id}
POST /v1beta/interactions/{id}/cancel
POST /v1beta/cachedContents
GET /v1beta/cachedContents
GET /v1beta/cachedContents/{name}
PATCH /v1beta/cachedContents/{name}
DELETE /v1beta/cachedContents/{name}
POST /upload/v1beta/files
GET /v1beta/files
GET /v1beta/files/{name}
DELETE /v1beta/files/{name}
GET /v1beta/models
/v1/models/{model}:generateContent 等路径与 /v1beta 相同(google-genai 3.x 的默认路径),GET /v1/models 与 /v1/files 带 x-goog-api-key 或不带 Authorization 的 ?key= 时按 Gemini 形状返回。
Interactions 与 Responses 一样保存到 data/requests.db 30 天,background: true 在后台运行,可流式取回、取消与删除。cachedContents 保存在服务内存中,默认 1 小时到期,服务重启后清空;生成与计数请求以 cachedContent 引用。
streamGenerateContent 不带 alt=sse 时返回 JSON 数组。上传的文件以 fileData.fileUri 引用,YouTube 链接按官网读取视频内容。predictLongRunning 使用 gemini-video。
Antigravity CLI(agy)使用 Gemini 接口。在 ~/.gemini/antigravity-cli/settings.json 中写入 {"modelProvider": "gemini"},设置以下环境变量后运行 agy,模型在 agy 中用 /model 选择:
$env:GEMINI_API_KEY = "<PROXY_API_KEY>" $env:GOOGLE_GEMINI_BASE_URL = "http://127.0.0.1:8007" agy
POST /mcp
MCP 客户端以 Streamable HTTP 连接 http://127.0.0.1:8007/mcp,认证方式与 API 相同。工具:web_search(Google 搜索后作答并列出来源)、generate_image(生成或修改图片)、generate_music、create_video_task 与 get_video_status、start_deep_research 与 get_deep_research;各工具的 model 参数可选模型目录中对应功能的模型。
GET /readyz
认证支持 Authorization: Bearer xxx、?key=xxx、x-goog-api-key 和 x-api-key。未设置 PROXY_API_KEY 时,浏览器中只有本机地址打开的网页可以调用接口,其他网站的网页需要服务设置 key 并在请求中携带。
请求头 X-Gemini-Web2API-Account: <账号 ID> 指定只由这个账号处理本次请求,账号 ID 即管理端“全部账号”页显示的 ID,与 API key 可用的账号取交集:账号不存在返回 400,不在 API key 可用范围内返回 403,账号冷却或不可用时返回说明原因的错误。
浏览器打开 http://127.0.0.1:8007/ 进入管理端,页面使用 /api/* 接口。
ADMIN_AUTH_ENABLED=true 与 ADMIN_PASSWORD,并让 LISTEN_ADDR 监听对外地址后,可从其他设备登录;同一客户端登录连续失败 5 次后,60 秒内它的登录返回 429 并带 Retry-AfterHost 头透传给服务,并以 X-Forwarded-For 转发客户端地址,nginx 写 proxy_set_header Host $http_host; 与 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;;本机反向代理转发的客户端地址用于本机访问判定、登录限流与请求记录;也可挂在子路径下,例如 nginx location /gemini/ { proxy_pass http://127.0.0.1:8007/; proxy_set_header Host $http_host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_buffering off; },管理端从 /gemini/ 打开,客户端的 Base URL 带上同一前缀.env,与默认值相同的项从 .env 中删去;监听地址、认证路径与日志格式重启后生效,其余立即生效;.env 中取值无效的项按默认值运行并在设置页顶部列出;由进程环境变量或 --auth、--listen 决定的项在设置页标出来源且不可修改PROXY 的第一个代理发出,未设置时使用系统代理;Docker 部署随镜像更新curl http://127.0.0.1:8007/v1/chat/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "从 /v1/models 获取的模型 ID", "messages": [{"role": "user", "content": "Hello"}], "reasoning_effort": "medium", "stream": true }'
OpenAI SDK 的 base URL 使用 http://127.0.0.1:8007/v1;Claude 和 Google GenAI SDK 使用 http://127.0.0.1:8007。常用客户端的配置在管理端“接入”页复制。
| 变量 | 说明 | 默认值 |
|---|---|---|
GEMINI_SAVE_HISTORY |
是否写入 Gemini 官网历史记录 | false |
GEMINI_CONTINUE_SESSION |
多轮对话续接上一轮所在的 Gemini 官网会话,只发送新消息(实验性) | false |
NONSTREAM_KEEPALIVE |
非流式请求等待结果期间每 10 秒写出一个换行 | true |
FAKE_STREAM |
流式请求收齐完整结果后再按流式输出 | false |
GEMINI_AUTH_STATES |
认证文件或目录,多个路径用逗号分隔 | auth |
LISTEN_ADDR |
服务监听地址 | 127.0.0.1:8007 |
PROXY_API_KEY |
本地 2API 访问密钥,多个 key 用逗号分隔 | 空 |
PROXY |
代理池,多个代理用逗号分隔 | 空 |
MODEL_MAPPING |
外部模型名到当前模型 ID 的映射 | 空 |
ACCOUNT_COOLDOWN |
账号失败后的冷却时间,上游频率限制从 1 分钟起连续翻倍,最长 10 分钟 | 2m |
SESSION_TTL |
显式会话状态的存活时间 | 30m |
INIT_TIMEOUT |
单账号启动初始化超时 | 20s |
PER_ACCOUNT_CONCURRENCY |
每个账号同时进行的上游请求数;等待上游首个输出满 1 分钟的请求让出名额,每个账号同时让出一个 | 1 |
ROUTING_STRATEGY |
无会话请求的调度策略 | round-robin |
LOG_LEVEL |
日志级别:debug、info、warn、error |
info |
LOG_FORMAT |
控制台日志格式:text 或 json |
text |
REQUEST_BODY_LOG |
是否在请求账本中保存最近 1000 条请求与响应正文 | false |
LOG_FILE |
同时把日志写入 data/logs/gemini-web2api.log,单文件 10 MB 轮转 |
true |
LOG_MAX_TOTAL_MB |
日志目录总量上限(MB),超出时删除最旧的文件,不小于 20 | 500 |
ADMIN_AUTH_ENABLED |
管理端登录 | false |
ADMIN_USERNAME |
管理端用户名 | admin |
ADMIN_PASSWORD |
管理端密码 | 空 |
API_KEY_ACCOUNTS |
API key 可用的账号,每项 key:账号|账号,多项用逗号分隔 |
空 |
ACCOUNT_ORDER |
fill-first 在上下文窗口相同的账号中依次使用的账号 ID,多个用逗号分隔 |
空 |
MODEL_ACCOUNTS |
模型可用的账号,每项 模型 ID:账号|账号,多项用逗号分隔 |
空 |
FIRST_EVENT_HEDGE |
首个输出备用请求:auto、等待秒数或 off |
auto |
FIRST_EVENT_HEDGE_MODELS |
发起首个输出备用请求的模型 ID,多个用逗号分隔 | gemini-4-carbon,gemini-4-argon |
MODEL_MAPPING 的格式为 别名:模型 ID,多项用逗号分隔。启动初始化失败的账号按 ACCOUNT_COOLDOWN 间隔重试。ROUTING_STRATEGY 为 round-robin 时从随机位置开始在账号间轮流分配,为 fill-first 时优先使用排在前面的空闲账号:先用上下文窗口最大的账号,窗口相同的账号按 ACCOUNT_ORDER 的顺序使用,未列出的账号按导入顺序排在后面。API_KEY_ACCOUNTS 未列出的 key 可用全部账号,列出的 key 只用指定账号且不使用访客会话。MODEL_ACCOUNTS 未列出的模型可用全部账号,列出的模型只在指定账号中选号,与 API_KEY_ACCOUNTS 同时生效;也可在管理端“模型”页的模型详情中勾选。FIRST_EVENT_HEDGE 在原请求迟迟没有首个输出时用另一个空闲账号发出同一请求,采用先返回的一个;auto 按各模型近 24 小时首个输出等待的 p95 发起。
命令行 --auth 和 --listen 可以覆盖认证路径与监听地址;--open-ui 控制启动后是否在浏览器中打开管理端,不带参数启动时默认打开。
开发与贡献见 docs/development.md,认证、请求载荷和流式解码原理见 docs/protocol.md,官网变化后的采集与对齐步骤见 docs/upstream.md,日志与请求账本见 docs/logging.md。
Mag1cFall/Gemini-Web2API is a public repo on GitHub by Mag1cFall. 将 Google Gemini Web 转换为 OpenAI、Claude 和 Gemini 兼容 API.
It declares the MIT license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-11-21. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.

将AI Studio Playground和Build反代成API | AI Studio to OpenAI, Anthropic & Gemini Compatible API

This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/Mag1cFall/Gemini-Web2APITake My Repo has not tested this on your machine. Requirements come from the project's own documentation.
