memory-bank/projectBrief.md

项目简报 (projectBrief.md)

项目名称

FastAPI API 转发代理 (SuperProxy)

项目目标

搭建一个通用的 FastAPI 应用程序，作为 API 转发代理。主要目标是转发对 Google Gemini API 的请求，特别是其 OpenAI 兼容 API。

核心功能

1. 接收来自客户端的 HTTP 请求（GET, POST, PUT, DELETE）。
2. 将这些请求转发到预配置的目标 API（例如 Gemini API）。
3. 处理请求头、查询参数和请求体。
4. 将目标 API 的响应（状态码、头部、响应体）返回给客户端。
5. 支持通过环境变量配置目标 API 的基 URL 和认证信息。
6. 提供一个简单的健康检查端点。

关键技术

• Python
• FastAPI
• Uvicorn
• httpx (异步 HTTP 客户端)
• python-dotenv (环境变量管理)

部署环境

Hugging Face Spaces (或任何支持 FastAPI 应用的 Python 环境)

当前状态

• FastAPI 代理应用已基本实现。
• 已配置通过环境变量 GEMINI_BASE_URL 和 GEMINI_API_KEY 转发到 Gemini 的 OpenAI 兼容 API。
• 已修复健康检查端点。
• 已将转发请求的 User-Agent 头修改为 curl/8.7.1。
• 在部署环境 (Hugging Face Spaces) 中，代理功能已通过 curl 命令验证成功。
• 在本地测试时，Gemini API 返回“User location is not supported for the API use.”错误，这可能是由于本地 IP 地址的区域限制。
• Postman 客户端在调用部署的代理时遇到“Error: incorrect header check”错误，这可能与 Postman 自动生成的头部有关。