417 字
2 分钟
Gemini的OpenAI API兼容性

Gemini 的 OpenAI API 兼容性支持详解#

Google Gemini 模型现已 原生支持 OpenAI API 格式的调用方式,这意味着你可以在保留现有调用逻辑的基础上,几乎零改动地将模型切换至 Gemini。

借助这一新特性,开发者可以直接通过 OpenAI 官方库(支持 Python 和 TypeScript/JavaScript)或 REST API 来接入 Gemini,只需 修改 base_url 并使用你的 Gemini API 密钥,即可完成无缝迁移。

如果你之前未使用过 OpenAI SDK,也可以直接调用 Gemini API,无需强依赖任何库。


如何接入 Gemini 的 OpenAI API 接口#

要使用兼容模式,只需将原本的 base_url 修改为以下地址:

base_url = "https://generativelanguage.googleapis.com/v1beta/openai/"

同时,确保你的请求头中包含有效的 Gemini API 密钥。

这样,你便可以通过与 OpenAI 接口完全一致的方式访问 Gemini 模型。


当前支持的功能列表#

Gemini 的 OpenAI 接口目前支持以下主要功能,涵盖多模态、生成、理解、结构化输出等核心能力:

功能(英文)功能(中文)
List models列出模型列表
Retrieve a model获取指定模型信息
Streaming流式输出
Function calling函数调用
Image understanding图像理解
Generate an image图像生成
Audio understanding音频理解
Structured output结构化输出
Embeddings向量嵌入生成

使用建议#

  • 已有 OpenAI 接口代码? 直接更新 base_url 和密钥即可快速接入 Gemini。
  • 尚未接入 OpenAI SDK? 推荐直接使用 Gemini 官方 API 接口,文档清晰,功能全面。

官方文档链接#

更多详细信息可参考 Gemini 官方文档:

👉 Gemini OpenAI 兼容接口说明

Gemini的OpenAI API兼容性
https://blog.wakaplus.com/posts/gemini-openai/
作者
waka
发布于
2025-04-08
许可协议
CC BY-NC-SA 4.0