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

配置说明

1

访问认证页面

在浏览器中打开:

http://127.0.0.1:7861/auth
2

完成 OAuth 认证

使用默认密码:pwd

按照页面指引完成 Google OAuth 认证流程

详细使用教程

1

安装 Gemini CLI

使用 npm 全局安装官方 Gemini CLI 工具:

npx https://github.com/google-gemini/gemini-cli
2

选择认证选项

运行命令后选择选项 1(用户认证):

? 选择认证方式 › - 使用箭头键选择,按回车确认
❯ 用户认证 (User Authentication)
  服务账号认证 (Service Account Authentication)
3

完成浏览器认证

按回车确认后,系统会自动打开浏览器完成 Google 账户认证:

  • • 在浏览器中选择要使用的 Google 账户
  • • 授予必要的 API 访问权限
  • • 认证完成后会自动返回命令行
4

获取凭证文件

认证成功后,系统会自动生成 JSON 凭证文件:

  • • 文件位置:./geminicli/creds/ 目录
  • • 文件名格式:credentials_*.json
  • • 包含完整的 API 访问凭证信息

故障排除 - 400 错误解决方案

问题描述

在使用过程中可能会遇到 400 Bad Request 错误,这通常是由于认证配置问题导致的。

解决方案

1

重新运行认证流程

确保按照上述详细教程的步骤重新进行认证

2

检查网络连接

确保网络连接稳定,能够正常访问 Google 服务

3

清除缓存文件

删除旧的凭证文件后重新认证:

rm -rf ./geminicli/creds/*.json
4

检查浏览器设置

确保浏览器允许弹出窗口,没有拦截认证页面的打开

⚠️ 注意事项

  • 当前 OAuth 验证流程仅支持本地主机(localhost)访问,即必须通过 http://127.0.0.1:7861/auth 完成认证
  • 如需在云服务器或其他远程环境部署,请先在本地运行服务并完成 OAuth 验证,获得生成的 json 凭证文件(位于 ./geminicli/creds 目录)后,再在auth面板将该文件上传
  • GitHub 项目地址:https://github.com/su-kaka/gcli2api,可查看最新更新和问题反馈

云端凭证获取教程

1

访问认证页面

打开浏览器访问:

http://gcli-auth.sukaka.top:7861/
2

登录认证

输入密码:pwd

按照网页指引完成Google账号登录

3

获取JSON文件

登录成功后:

  • • 选择"获取JSON"按钮
  • • 系统会自动获取project id并开启服务
  • • 复制内容或直接下载JSON文件

⚠️ 注意事项

  • • 如果页面显示报错,请手动将地址栏的localhost改为gcli-auth.sukaka.top后重新访问
  • • 请妥善保管获取的JSON文件,不要泄露给他人
  • • 获取凭证后可以上传捐赠给星星人民公益站

捐赠指引

获取到 JSON 凭证文件后,您可以通过以下方式捐赠给星星人民公益站:

上传凭证文件

点击上传凭证文件

获取JSON凭证文件后,请使用此链接上传