Upload 9 files

.env.example

@@ -0,0 +1,62 @@
+# ============================================
+# Gemini Business2API 配置示例
+# ============================================
+
+# 代理设置（可选）
+# PROXY=http://127.0.0.1:7890
+
+# API 访问密钥（可选，用于保护 API 端点）
+# API_KEY=your-secret-api-key-here
+
+# 路径前缀（必需，用于隐藏端点路径）
+PATH_PREFIX=your-random-path-prefix
+
+# 管理员密钥（必需，用于访问管理端点）
+ADMIN_KEY=your-admin-secret-key
+
+# 服务器完整 URL（可选，用于反代公开日志和图片 URL）
+# BASE_URL=https://your-domain.com
+
+# ============================================
+# 高级配置（可选，使用默认值）
+# ============================================
+
+# 新会话创建最多尝试账户数（默认：5）
+# MAX_NEW_SESSION_TRIES=5
+
+# 请求失败最多重试次数（默认：3）
+# MAX_REQUEST_RETRIES=3
+
+# 每次重试找账户的最大尝试次数（默认：5）
+# MAX_ACCOUNT_SWITCH_TRIES=5
+
+# 账户连续失败阈值（默认：3次）
+# ACCOUNT_FAILURE_THRESHOLD=3
+
+# 账户冷却时间，单位秒（默认：300秒=5分钟）
+# ACCOUNT_COOLDOWN_SECONDS=300
+
+# 会话缓存过期时间，单位秒（默认：3600秒=1小时）
+# SESSION_CACHE_TTL_SECONDS=3600
+
+# ============================================
+# 公开展示配置（可选）
+# ============================================
+# Logo URL（公开，为空则不显示）
+# LOGO_URL=https://your-domain.com/logo.png
+
+# 开始对话链接（公开，为空则不显示）
+# CHAT_URL=https://your-chat-app.com
+
+# 模型名称（公开，默认：gemini-business）
+# MODEL_NAME=gemini-business
+
+# ============================================
+# 多账户配置（必需）
+# ============================================
+# 使用 JSON 数组格式配置多个 Gemini 账户
+# 必需字段：secure_c_ses, csesidx, config_id
+# 可选字段：id, host_c_oses, proxy, expires_at
+# 详细配置请参考 accounts_config.example.json
+
+ACCOUNTS_CONFIG=[{"secure_c_ses":"your-cookie-here","csesidx":"your-idx","config_id":"your-config","proxy":""}]

.gitattributes

@@ -1,35 +1,2 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
-*.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text
+# Auto detect text files and perform LF normalization
+* text=auto

.gitignore

@@ -0,0 +1,47 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+venv/
+env/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Project specific
+.env
+*.log
+stats.json
+
+# Generated files
+images/
+static/
+logs/
+
+# OS
+.DS_Store
+Thumbs.db

Dockerfile

@@ -0,0 +1,13 @@
+FROM python:3.11-slim
+WORKDIR /app
+COPY requirements.txt .
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    gcc \
+    && pip install --no-cache-dir -r requirements.txt \
+    && apt-get purge -y gcc \
+    && apt-get autoremove -y \
+    && rm -rf /var/lib/apt/lists/*
+COPY main.py .
+# 复制 util 目录
+COPY util ./util
+CMD ["python", "-u", "main.py"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 yu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,11 +1,342 @@
----
-title: Gemini Business2api
-emoji: 👀
-colorFrom: blue
-colorTo: pink
-sdk: docker
-pinned: false
-license: mit
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+#  Gemini Business2API
+
+将 Google Gemini Business API 转换为 OpenAI 兼容接口，支持多账户负载均衡。
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+**快速部署到 HuggingFace Spaces:**
+
+[![Deploy to Spaces](https://huggingface.co/datasets/huggingface/badges/resolve/main/deploy-to-spaces-md.svg)](https://huggingface.co/spaces/YOUR_USERNAME/gemini-business2api?duplicate=true)
+
+## ✨ 功能特性
+
+- ✅ **OpenAI API 完全兼容** - 无缝对接现有工具
+- ✅ **流式响应支持** - 实时输出
+- ✅ **多模态支持** - 文本 + 图片输入
+- ✅ **图片生成 & 图生图** - 支持 `gemini-3-pro-preview` 模型
+- ✅ **多账户负载均衡** - 支持多账户轮询，故障自动转移
+- ✅ **智能会话复用** - 自动管理对话历史
+- ✅ **JWT自动管理** - 无需手动刷新令牌
+- 📊 **可视化管理面板** - 实时监控账户状态
+- 📝 **公开日志系统** - 实时查看服务运行状态
+
+## 📸 功能展示
+
+### 管理面板
+<!-- 在这里添加管理面板截图 -->
+
+### 图片生成效果
+<!-- 在这里添加图片生成示例截图 -->
+
+### 公开日志系统
+<!-- 在这里添加日志系统截图 -->
+
+## 🚀 快速开始
+
+### 方法一: HuggingFace Spaces 部署（推荐）
+
+1. Fork 本项目到你的 GitHub 账户
+2. 在 [HuggingFace Spaces](https://huggingface.co/spaces) 创建新 Space
+3. 选择 Docker SDK，关联你的 GitHub 仓库
+4. 配置环境变量（Settings → Variables and secrets）：
+   ```bash
+   ACCOUNTS_CONFIG='[{"secure_c_ses":"your_cookie","csesidx":"your_idx","config_id":"your_config"}]'
+   PATH_PREFIX=path_prefix
+   ADMIN_KEY=your_admin_key
+   API_KEY=your_api_key
+   LOGO_URL=https://your-domain.com/logo.png
+   CHAT_URL=https://your-chat-app.com
+   ```
+5. 等待构建完成（约 2-3 分钟）
+6. 访问你的 Space URL 开始使用
+
+### 方法二: Docker 部署
+
+```bash
+# 1. 克隆项目
+git clone https://github.com/YOUR_USERNAME/gemini-business2api.git
+cd gemini-business2api
+
+# 2. 构建并运行
+docker build -t gemini-business2api .
+docker run -d \
+  -p 7860:7860 \
+  -e ACCOUNTS_CONFIG='[{"secure_c_ses":"your_cookie","csesidx":"your_idx","config_id":"your_config"}]' \
+  -e PATH_PREFIX=path_prefix \
+  -e ADMIN_KEY=your_admin_key \
+  -e API_KEY=your_api_key \
+  -e LOGO_URL=https://your-domain.com/logo.png \
+  -e CHAT_URL=https://your-chat-app.com \
+  gemini-business2api
+```
+
+### 方法三: 本地运行
+
+```bash
+# 1. 安装依赖
+pip install -r requirements.txt
+
+# 2. 配置环境变量
+cp .env.example .env
+# 编辑 .env 文件，填入实际配置
+
+# 3. 启动服务
+python main.py
+```
+
+服务将在 `http://localhost:7860` 启动
+
+## ⚙️ 配置说明
+
+### 必需的环境变量
+
+```bash
+# 账户配置（必需）
+ACCOUNTS_CONFIG='[{"secure_c_ses":"your_cookie","csesidx":"your_idx","config_id":"your_config"}]'
+
+# 路径前缀（必需）
+PATH_PREFIX=path_prefix
+
+# 管理员密钥（必需）
+ADMIN_KEY=your_admin_key
+
+# API访问密钥（可选，推荐设置）
+API_KEY=your_api_key
+
+# 图片URL生成（可选，推荐设置）
+BASE_URL=https://your-domain.com
+
+# 全局代理（可选）
+PROXY=http://127.0.0.1:7890
+
+# 公开展示配置（可选）
+LOGO_URL=https://your-domain.com/logo.png
+CHAT_URL=https://your-chat-app.com
+MODEL_NAME=gemini-business
+```
+
+### 多账户配置示例
+
+```bash
+ACCOUNTS_CONFIG='[
+  {
+    "id": "account_1",
+    "secure_c_ses": "CSE.Ad...",
+    "csesidx": "498...",
+    "config_id": "0cd...",
+    "host_c_oses": "COS.Af...",
+    "expires_at": "2025-12-23 23:03:20"
+  },
+  {
+    "id": "account_2",
+    "secure_c_ses": "CSE.Ad...",
+    "csesidx": "208...",
+    "config_id": "782..."
+  }
+]'
+```
+
+**配置字段说明**:
+- `secure_c_ses` (必需): `__Secure-C_SES` Cookie 值
+- `csesidx` (必需): 会话索引
+- `config_id` (必需): 配置 ID
+- `id` (可选): 账户标识
+- `host_c_oses` (可选): `__Host-C_OSES` Cookie 值
+- `expires_at` (可选): 过期时间，格式 `YYYY-MM-DD HH:MM:SS`
+
+**提示**: 参考项目根目录的 `.env.example` 和 `accounts_config.example.json` 文件
+
+## 🔧 获取配置参数
+
+1. 访问 [Google Gemini Business](https://business.gemini.google)
+2. 打开浏览器开发者工具 (F12)
+3. 切换到 **Application** → **Cookies**，找到:
+   - `__Secure-C_SES` → `secure_c_ses`
+   - `__Host-C_OSES` → `host_c_oses` (可选)
+4. 切换到 **Network** 标签，刷新页面
+5. ��到 `streamGenerate` 请求，查看 Payload:
+   - `csesidx` → `csesidx`
+   - `configId` → `config_id`
+
+## 📖 API 使用
+
+### 支持的模型
+
+| 模型名称                 | 说明                   | 图片生成 |
+| ------------------------ | ---------------------- | -------- |
+| `gemini-auto`            | 自动选择最佳模型(默认) | ❌        |
+| `gemini-2.5-flash`       | Flash 2.5 - 快速响应   | ❌        |
+| `gemini-2.5-pro`         | Pro 2.5 - 高质量输出   | ❌        |
+| `gemini-3-flash-preview` | Flash 3 预览版         | ❌        |
+| `gemini-3-pro-preview`   | Pro 3 预览版           | ✅        |
+
+### 基本对话
+
+```bash
+curl -X POST http://localhost:7860/v1/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer your_api_key" \
+  -d '{
+    "model": "gemini-2.5-flash",
+    "messages": [
+      {"role": "user", "content": "Hello!"}
+    ],
+    "stream": true
+  }'
+```
+
+### 图片输入（多模态）
+
+```bash
+curl -X POST http://localhost:7860/v1/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer your_api_key" \
+  -d '{
+    "model": "gemini-2.5-pro",
+    "messages": [
+      {
+        "role": "user",
+        "content": [
+          {"type": "text", "text": "这张图片里有什么?"},
+          {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,<base64_encoded_image>"}}
+        ]
+      }
+    ]
+  }'
+```
+
+### 图片生成
+
+```bash
+curl -X POST http://localhost:7860/v1/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer your_api_key" \
+  -d '{
+    "model": "gemini-3-pro-preview",
+    "messages": [
+      {"role": "user", "content": "画一只可爱的猫咪"}
+    ]
+  }'
+```
+
+### 图生图（Image-to-Image）
+
+```bash
+curl -X POST http://localhost:7860/v1/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer your_api_key" \
+  -d '{
+    "model": "gemini-3-pro-preview",
+    "messages": [
+      {
+        "role": "user",
+        "content": [
+          {"type": "text", "text": "将这张图片改成水彩画风格"},
+          {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,<base64_encoded_image>"}}
+        ]
+      }
+    ]
+  }'
+```
+
+### 其他端点
+
+| 端点                       | 方法 | 说明                  |
+| -------------------------- | ---- | --------------------- |
+| `/{PATH_PREFIX}/v1/models` | GET  | 获取模型列表          |
+| `/{PATH_PREFIX}/admin`     | GET  | 管理面板(需ADMIN_KEY) |
+| `/public/log/html`         | GET  | 公开日志页面          |
+| `/health`                  | GET  | 健康检查              |
+
+## ❓ 常见问题
+
+### 1. 图片生成后在哪里找到文件?
+
+- **临时存储**: 图片保存在 `./images/`，可通过 URL 访问
+- **重启后会丢失**，建议使用持久化存储
+
+### 2. 如何设置 BASE_URL?
+
+**自动检测**(推荐):
+- 不设置 `BASE_URL` 环境变量
+- 系统自动从请求头检测域名
+
+**手动设置**:
+```bash
+BASE_URL=https://your-domain.com
+```
+
+**使用反向代理**:
+
+如果你使用自己的域名反向代理到 HuggingFace Space，可以通过以下方式配置：
+
+**Nginx 配置示例**:
+```nginx
+location / {
+    proxy_pass https://your-username-space-name.hf.space;
+    proxy_set_header Host your-username-space-name.hf.space;
+    proxy_ssl_server_name on;
+}
+```
+
+**Deno Deploy 配置示例**:
+```typescript
+async function handler(request: Request): Promise<Response> {
+  const url = new URL(request.url);
+  url.host = 'your-username-space-name.hf.space';
+  return fetch(new Request(url, request));
+}
+
+Deno.serve(handler);
+```
+
+配置反向代理后，将 `BASE_URL` 设置为你的自定义域名即可。
+
+### 3. API_KEY 和 ADMIN_KEY 的区别?
+
+- **API_KEY**: 保护聊天接口 (`/v1/chat/completions`)
+- **ADMIN_KEY**: 保护管理面板 (`/admin`)
+
+可以设置相同的值，也可以分开
+
+### 4. 如何查看日志?
+
+- **公开日志**: 访问 `/public/log/html` (无需密钥)
+- **管理面板**: 访问 `/admin?key=YOUR_ADMIN_KEY`
+
+## 📁 项目结构
+
+```
+gemini-business2api/
+├── main.py                        # 主程序
+├── util/                          # 工具模块
+│   └── streaming_parser.py
+├── requirements.txt               # Python依赖
+├── Dockerfile                     # Docker构建
+├── README.md                      # 项目文档
+├── .env.example                   # 环境变量配置示例
+├── accounts_config.example.json   # 多账户配置示例
+└── .gitignore                     # Git忽略文件
+```
+
+**运行时生成的目录**:
+- `images/` - 生成的图片存储
+- `static/` - 静态文件缓存
+- `logs/` - 日志文件
+
+## 🛠️ 技术栈
+
+- **Python 3.11+**
+- **FastAPI** - 现代Web框架
+- **Uvicorn** - ASGI服务器
+- **httpx** - HTTP客户端
+- **Docker** - 容器化部署
+
+## 📝 License
+
+MIT License - 查看 [LICENSE](LICENSE) 文件了解详情
+
+---
+
+**如果这个项目对你有帮助，请给个 ⭐ Star!**

accounts_config.example.json

@@ -0,0 +1,26 @@
+[
+  {
+    "id": "account_1",
+    "csesidx": "498...",
+    "config_id": "0cd...",
+    "secure_c_ses": "CSE.Ad...",
+    "host_c_oses": "COS.Af...",
+    "expires_at": "2025-12-23 23:03:20"
+  },
+  {
+    "id": "account_2",
+    "csesidx": "208...",
+    "config_id": "782...",
+    "secure_c_ses": "CSE.Ad...",
+    "host_c_oses": "COS.Af...",
+    "expires_at": "2025-12-23 23:04:02"
+  },
+  {
+    "id": "account_3",
+    "csesidx": "789...",
+    "config_id": "92e...",
+    "secure_c_ses": "CSE.Ad...",
+    "host_c_oses": "COS.Af...",
+    "expires_at": "2025-12-23 23:04:36"
+  }
+]

requirements.txt

@@ -0,0 +1,4 @@
+fastapi==0.110.0
+uvicorn[standard]==0.29.0
+httpx==0.27.0
+pydantic==2.7.0