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-proxyGemini-OpenAI-Proxy是一款强大的API协议转换工具它能将OpenAI API协议无缝转换为Google Gemini协议让基于OpenAI API开发的应用轻松对接Gemini服务支持聊天补全、嵌入和模型端点等核心功能。本文将为开发者提供快速上手指南通过清晰的API调用示例和参数说明帮助你在10分钟内掌握这款工具的使用方法。快速部署3种简单方法任选Docker命令行一键部署 ⚡最快捷的部署方式是使用Docker命令直接运行官方镜像docker run --restartunless-stopped -it -d -p 8080:8080 --name gemini zhu327/gemini-openai-proxy:latestDocker Compose配置部署 创建docker-compose.yml文件自定义环境变量和端口映射version: 3 services: gemini: container_name: gemini environment: - GPT_4_VISION_PREVIEWgemini-1.5-flash-latest # 模型映射配置 - DISABLE_MODEL_MAPPING0 # 启用模型自动映射 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 # 运行服务 ./geminiAPI调用实战从基础到高级准备工作获取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模型名称对应Gemini模型gpt-4gemini-1.5-flash-002gpt-4-turbo-previewgemini-1.5-pro-latestgpt-4ogemini-2.0-flash-exptext-embedding-ada-002text-embedding-004环境变量配置 ⚙️通过环境变量自定义代理行为GPT_4_VISION_PREVIEW: 自定义gpt-4-vision-preview映射模型如gemini-1.5-pro-latestDISABLE_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/openaiGemini-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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考