docker-configs/simple-gemini-proxy/README.md

Simple Gemini to OpenAI API Proxy

这是一个极其简单的Gemini到OpenAI API格式的代理服务，基于 zhu327/gemini-openai-proxy 项目。

特点

• ✅ 无需数据库
• ✅ 配置极其简单，只需要API密钥
• ✅ 支持Docker部署
• ✅ 立即可用，无需复杂配置
• ✅ 支持OpenAI API格式调用Gemini模型

快速开始

1. 获取Gemini API密钥

访问 Google AI Studio 获取免费的Gemini API密钥。

2. 启动服务

# 启动代理服务
docker-compose up -d

# 查看日志
docker-compose logs -f

3. 测试服务

# 使用你的Gemini API密钥替换 YOUR_GEMINI_API_KEY
curl http://localhost:8081/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_GEMINI_API_KEY" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "你好！"}],
    "temperature": 0.7
  }'

使用说明

API端点

• 基础URL: http://localhost:8081
• 聊天完成: POST /v1/chat/completions

模型映射

默认的模型映射：

• gpt-3.5-turbo → gemini-1.5-flash-latest
• gpt-4 → gemini-1.5-pro-latest
• gpt-4-vision-preview → gemini-1.5-flash-latest

环境变量配置

在 docker-compose.yml 中可以配置：

• DISABLE_MODEL_MAPPING=1: 禁用模型映射，直接使用Gemini模型名称
• GPT_4=gemini-1.5-pro-latest: 自定义模型映射

与各种客户端集成

使用curl

curl http://localhost:8081/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_GEMINI_API_KEY" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

使用Python OpenAI库

import openai

client = openai.OpenAI(
    api_key="YOUR_GEMINI_API_KEY",
    base_url="http://localhost:8081/v1"
)

response = client.chat.completions.create(
    model="gpt-3.5-turbo",
    messages=[{"role": "user", "content": "Hello!"}]
)

print(response.choices[0].message.content)

管理命令

# 启动服务
docker-compose up -d

# 停止服务
docker-compose down

# 重启服务
docker-compose restart

# 查看状态
docker-compose ps

# 查看日志
docker-compose logs -f gemini-proxy

注意事项

1. API密钥安全: 请确保妥善保管你的Gemini API密钥
2. 网络访问: 默认绑定到8081端口，如需外部访问请配置防火墙
3. 速率限制: 遵循Google Gemini API的速率限制
4. 生产环境: 如用于生产环境，建议添加认证和HTTPS

故障排除

容器无法启动

# 检查端口是否被占用
sudo netstat -tlnp | grep 8081

# 查看详细错误日志
docker-compose logs gemini-proxy

API调用失败

1. 检查API密钥是否正确
2. 确认网络连接正常
3. 检查请求格式是否符合OpenAI API规范

项目信息

• 基于项目: zhu327/gemini-openai-proxy
• Docker镜像: zhu327/gemini-openai-proxy:latest
• 支持的模型: Gemini 1.5 Pro, Gemini 1.5 Flash