Gemini CLI 凭证获取捐赠教程
教程说明
本教程将指导您如何在本地通过 Gemini CLI 工具获取 API 凭证文件,用于捐赠给星星人民公益站。 您的捐赠将帮助更多人免费使用先进的 AI 技术!
安装指南
Termux 环境
每次开启termux运行这个脚本即可,进程会自动后台运行
curl -o termux-install.sh "https://raw.githubusercontent.com/su-kaka/gcli2api/refs/heads/master/termux-install.sh" && chmod +x termux-install.sh && ./termux-install.sh
Windows 环境
初始安装,选择一个你喜欢的文件夹,右键选择打开控制台
iex (iwr "https://raw.githubusercontent.com/su-kaka/gcli2api/refs/heads/master/install.ps1" -UseBasicParsing).Content
下一次需要启动:双击执行 start.bat
Linux 环境
初始安装
curl -o install.sh "https://raw.githubusercontent.com/su-kaka/gcli2api/refs/heads/master/install.sh" && chmod +x install.sh && ./install.sh
下一次需要启动:
cd gcli2api bash start.sh
配置说明
访问认证页面
在浏览器中打开:
http://127.0.0.1:7861/auth
完成 OAuth 认证
使用默认密码:pwd
按照页面指引完成 Google OAuth 认证流程
详细使用教程
安装 Gemini CLI
使用 npm 全局安装官方 Gemini CLI 工具:
npx https://github.com/google-gemini/gemini-cli
选择认证选项
运行命令后选择选项 1(用户认证):
? 选择认证方式 › - 使用箭头键选择,按回车确认 ❯ 用户认证 (User Authentication) 服务账号认证 (Service Account Authentication)
完成浏览器认证
按回车确认后,系统会自动打开浏览器完成 Google 账户认证:
- • 在浏览器中选择要使用的 Google 账户
- • 授予必要的 API 访问权限
- • 认证完成后会自动返回命令行
获取凭证文件
认证成功后,系统会自动生成 JSON 凭证文件:
- • 文件位置:
./geminicli/creds/目录 - • 文件名格式:
credentials_*.json - • 包含完整的 API 访问凭证信息
故障排除 - 400 错误解决方案
问题描述
在使用过程中可能会遇到 400 Bad Request 错误,这通常是由于认证配置问题导致的。
解决方案
重新运行认证流程
确保按照上述详细教程的步骤重新进行认证
检查网络连接
确保网络连接稳定,能够正常访问 Google 服务
清除缓存文件
删除旧的凭证文件后重新认证:
rm -rf ./geminicli/creds/*.json
检查浏览器设置
确保浏览器允许弹出窗口,没有拦截认证页面的打开
⚠️ 注意事项
-
当前 OAuth 验证流程仅支持本地主机(localhost)访问,即必须通过
http://127.0.0.1:7861/auth完成认证 -
如需在云服务器或其他远程环境部署,请先在本地运行服务并完成 OAuth 验证,获得生成的 json 凭证文件(位于
./geminicli/creds目录)后,再在auth面板将该文件上传 -
GitHub 项目地址:https://github.com/su-kaka/gcli2api,可查看最新更新和问题反馈
云端凭证获取教程
登录认证
输入密码:pwd
按照网页指引完成Google账号登录
获取JSON文件
登录成功后:
- • 选择"获取JSON"按钮
- • 系统会自动获取project id并开启服务
- • 复制内容或直接下载JSON文件
⚠️ 注意事项
- • 如果页面显示报错,请手动将地址栏的localhost改为gcli-auth.sukaka.top后重新访问
- • 请妥善保管获取的JSON文件,不要泄露给他人
- • 获取凭证后可以上传捐赠给星星人民公益站