当前位置：首页 > news >正文

【2026可用】Clawcloud Run+gemini balance+cherrystudio轮询号池配置手把手配置图文教程

news 2026/3/27 3:44:39

背景

Ai studio能够提供一些免费的API，但是这些免费层级的API，有速率限制，如果可多个API轮询使用，可以缓解单个免费API的使用负载，并且增加这个限额.gemini balance 这个项目，能够对gemini的API实现轮询.clawcloud run是一个云端服务器，能够在云端拉取镜像，进行项目的云端部署，本文结合clawcloud run+gemini balance项目，使用免费的云端服务器(前提是你有一个使用超过180天的github账号，如果没有，就不免费)，实现部署，并最终使用cherry studio对API进行调用测试，这个API同样可以迁移到其他需要接入API的项目。虽然在B站已有相关教程，教学如何使用clawcloud run+gemini balance项目，但本人实践过程中，发现教程老旧，有很多内容(参数配置)已经对不上，所以将自己的实践操作过程进行手把手教学，记录自己的完整操作流程，便于跟随，一遍实现运行。

操作步骤

后续将分三个部分，第一部分，clawcloud部分，新建一个容器，并配置文件，实现容器的正常运行，为后续部署打基础。第二部分是成功部署gemini balance的面板后，详细的配置。最后一部分是，详细说明，在cherrystudio上真实调用API，需要注意的填入的内容细节，别填错。

注意，gemin的API，并不是所有人的账号都有免费层级API，需要看新建的API密钥下方是否写有"免费层级"，对比一下就能看出区别。

一、clawcloud run的环境新建与配置

后续clawcloud均缩写为claw，gemini balance缩写为gb，cherrystudio缩写为cherry.

1.打开claw网址，使用github登录

网址：clawcloud run
右上角get started->github登录(github账号必须大于180天才有5美元免费赠金)

2.找到App Lanchpad，新建一个APP

打开app launchpad新建一个app->右上角create app

3.进入新建APP的配置界面后，填写配置

填写一个项目名称比如geminibalance(但是注意，不要有大小，全小写)
勾选image镜像为Public，镜像地址：ghcr.io/snailyp/gemini-balance:latest
选择CPU与Memory，CPU和memory看左侧价格，total是一天的价格,5美元赠金一个月，不要超出即可。
端口，container Port ，镜像暴露8000端口(我看的教程写的是7860，但项目仓库的readme写的是8000)，将Public Access勾选，因为我们需要得到外部地址，才能访问面板。
不管command和arguments，继续找到Enviroment Variables找到环境变量，点Add添加环境变量。
环境变量模板:

DATABASE_TYPE=sqlite
SQLITE_DATABASE=default_db
API_KEYS=["apikey1"，"apikey2"]
ALLOWED_TOKENS=["号池的访问api"] # 这你随便填，一会自己访问就用这个
AUTH_TOKEN=sk-123456  #一会管理界面的密码
TZ=Asia/Shanghai

AUTH_TOKEN是一会进面板要用的管理员密码，自己设定，请记住，一会要用，API_KEYS是你要轮询的多个gemin API，ALLOWED_TOKENS:我们最终不用原来gemini的API，而是一个自己编辑的API，来调用轮询后的模型。
模板中暂时就这些参数填入，其他更多参数，参考作者仓库的redeme，仓库链接在文章最后。
都填好后，拉到当前配置页面最上方，找到create app.创建需要时间，需要静待，当显示runing后，说明配置成功。

4.当运行成功后，访问管理面板

看到running表示配置成功，找到public Address，这个地址点进去，就是面板地址。
进入面板后，输入密码，就是前面的AUTH_TOKEN

二、geminibalance面板配置

进入面板后，找到配置编辑，后续增加API，修改面板密码都在这里配置
前面照着做，API密钥已经输入过了，就不需要再"配置编辑"了
"允许的令牌"就是你要调用轮询后的API，自己设置的那个token，回头调用就填这个，而不是原始gemini复制的API
"认证令牌"就是进入管理界面的密码
API的基础URL不需要修改，都配置好了，这就是gemini调用的API，服务器会从这个地址调用。
模型配置，请找ai studio去复制，而不是自己瞎写2.5或者3.0

三、cherrystudio 测试使用

现在服务器已经配置好，使用cherry进行测试，

cherry需要填三个东西，URL地址、API密钥和模型，其他编程工具比如claudecode(需要转换URL地址，我另有一篇文章写了)，trae(trae不支持自定义的URL去调用APi，Cline也许可以)或者obsidian的smart composer等工具，也都是填url和API和模型名称。
具体填什么：API密钥就是ALLOWED_TOKENS，API地址，就是进入面板的地址(一模一样复制过来)，模型，我填的是gemini-flash-latest，然后就可以正常去对话了。