刚薅到 GCP,想把 Vertex AI 的 Gemini 在本地接到 Cherry 上玩玩。
不想搭 API 管理系统,没找到合适的转换工具于是自己搓了一个。
Vertex AI 这个应该还是用的 300 刀赠金吧,1000 刀那个是 Agent Builder 的。
使用方法
-
谷歌云认证,两种方法可选
- gcloud CLI
- 安装 gcloud CLI。
- 运行
gcloud auth application-default login来进行认证。
- 服务账号密钥文件
- 在谷歌云控制台里创建服务账号密钥,参考这个教程。
- 下载 json 密钥文件。
- 将环境变量
GOOGLE_APPLICATION_CREDENTIALS设为密钥文件路径。
- gcloud CLI
-
运行此工具(注意配置文件会创建在当前目录里)
uvx simple-vertex-bridge直接运行。- 或者克隆仓库,
uv sync,然后运行python svbridge.py。
模型列表接口:http://localhost:8086/v1/models(v1 可省略)
聊天接口:http://localhost:8086/v1/chat/completions(v1 可省略)
密钥随便填,会被替换为 Vertex 的一小时 Token。
暂不支持除了聊天之外的其他接口,因为我自己没用到。
聊天接口是原版的 openapi 兼容接口加上自动刷新 token,模型列表是从谷歌的 api 转换来的。
列表里的模型除了 Gemini 好像还有 Claude 和 Llama,不过 Gemini 2.5 以外的我还没试过。
谷歌没给列出所有模型的接口,所以默认只扫描了提供商 google、anthropic、meta,如果需要别的可以自己加。
模型默认只保留 google/gemini-*、anthropic/claude-*、meta/llama*,不然太多了,很多都不是聊天模型。
可以本地启动之后接到 Cherry Studio 和 Roo Code 里玩。
v0.3.0 更新
增加了命令行参数 --port, --bind, --key, --auto-refresh, --filter-model-names。
命令行参数只需使用一次,会保存到配置中。
现在可以指定 API Key,Key 正确才允许访问。



