10分钟上手Gemini-OpenAI-Proxy：开发者必看的API调用示例与参数说明

10分钟上手Gemini-OpenAI-Proxy：开发者必看的API调用示例与参数说明

【免费下载链接】gemini-openai-proxyA proxy for converting the OpenAI API protocol to the Google Gemini Pro protocol.项目地址: https://gitcode.com/gh_mirrors/ge/gemini-openai-proxy

Gemini-OpenAI-Proxy是一款强大的API协议转换工具，它能将OpenAI API协议无缝转换为Google Gemini协议，让基于OpenAI API开发的应用轻松对接Gemini服务，支持聊天补全、嵌入和模型端点等核心功能。本文将为开发者提供快速上手指南，通过清晰的API调用示例和参数说明，帮助你在10分钟内掌握这款工具的使用方法。

快速部署：3种简单方法任选

Docker命令行一键部署 ⚡

最快捷的部署方式是使用Docker命令直接运行官方镜像：

docker run --restart=unless-stopped -it -d -p 8080:8080 --name gemini zhu327/gemini-openai-proxy:latest

Docker Compose配置部署 📝

创建docker-compose.yml文件，自定义环境变量和端口映射：

version: '3' services: gemini: container_name: gemini environment: - GPT_4_VISION_PREVIEW=gemini-1.5-flash-latest # 模型映射配置 - DISABLE_MODEL_MAPPING=0 # 启用模型自动映射 ports: - "8080:8080" # 端口映射 image: zhu327/gemini-openai-proxy:latest restart: unless-stopped

执行部署命令：docker-compose up -d

源码编译部署 🔨

如果你需要自定义功能，可以从源码编译部署：

# 克隆仓库 git clone https://gitcode.com/gh_mirrors/ge/gemini-openai-proxy cd gemini-openai-proxy # 编译可执行文件 go build -o gemini main.go # 运行服务 ./gemini

API调用实战：从基础到高级

准备工作：获取API密钥 🔑

在开始之前，你需要从ai.google.dev获取Google AI Studio API密钥，这个密钥将作为你的"OpenAI API密钥"使用。

基础聊天补全示例 💬

使用gpt-3.5-turbo模型进行简单对话（实际会映射到Gemini模型）：

curl http://localhost:8080/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $YOUR_GOOGLE_AI_STUDIO_API_KEY" \ -d '{ "model": "gpt-3.5-turbo", "messages": [{"role": "user", "content": "Say this is a test!"}], "temperature": 0.7 }'

多模态视觉分析示例 🖼️

通过gpt-4-vision-preview模型分析图片内容：

curl http://localhost:8080/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $YOUR_GOOGLE_AI_STUDIO_API_KEY" \ -d '{ "model": "gpt-4-vision-preview", "messages": [{"role": "user", "content": [ {"type": "text", "text": "What’s in this image?"}, { "type": "image_url", "image_url": { "url": "https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Gfp-wisconsin-madison-the-nature-boardwalk.jpg/2560px-Gfp-wisconsin-madison-the-nature-boardwalk.jpg" } } ]}], "temperature": 0.7 }'

文本嵌入生成示例 🔤

使用text-embedding-ada-002模型生成文本嵌入向量：

curl http://localhost:8080/v1/embeddings \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $YOUR_GOOGLE_AI_STUDIO_API_KEY" \ -d '{ "model": "text-embedding-ada-002", "input": ["This is a test sentence.", "This is another test sentence"] }'

核心参数详解与配置

模型映射关系表 🗺️

默认情况下，工具会自动将OpenAI模型名称映射为对应的Gemini模型：

环境变量配置 ⚙️

通过环境变量自定义代理行为：

• GPT_4_VISION_PREVIEW: 自定义gpt-4-vision-preview映射模型，如gemini-1.5-pro-latest
• DISABLE_MODEL_MAPPING: 设置为1禁用模型映射，直接使用Gemini模型名称

禁用模型映射示例：

curl http://localhost:8080/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $YOUR_GOOGLE_AI_STUDIO_API_KEY" \ -d '{ "model": "gemini-1.0-pro-latest", # 直接使用Gemini模型名称 "messages": [{"role": "user", "content": "Say this is a test!"}], "temperature": 0.7 }'

常见问题解决

如何修改服务端口？

通过Docker端口映射修改，例如将8080端口改为9000：-p 9000:8080

支持哪些OpenAI API端点？

目前支持：

• /v1/chat/completions- 聊天补全
• /v1/embeddings- 文本嵌入
• /v1/models- 模型列表

如何查看日志？

Docker部署可通过以下命令查看日志：docker logs -f gemini

项目结构与扩展

项目核心代码组织清晰，主要分为API处理和协议转换两部分：

• API处理：api/handler.go 和 api/router.go
• 协议转换：pkg/adapter/chat.go、pkg/adapter/image.go 等

如果你需要扩展功能，可以通过修改这些文件实现自定义的协议转换逻辑。

重要提示

Google AI Studio现已提供官方的OpenAI兼容API端点，推荐用户参考官方文档：https://ai.google.dev/gemini-api/docs/openai

Gemini-OpenAI-Proxy采用MIT许可，详细信息参见LICENSE文件。通过本文介绍的方法，你已经掌握了Gemini-OpenAI-Proxy的核心使用技巧，现在就可以开始将你的OpenAI应用无缝迁移到Gemini平台了！

【免费下载链接】gemini-openai-proxyA proxy for converting the OpenAI API protocol to the Google Gemini Pro protocol.项目地址: https://gitcode.com/gh_mirrors/ge/gemini-openai-proxy