OpenAI 兼容性

您可以使用 OpenAI 库(Python 和 TypeScript / JavaScript)以及 REST API 来访问 Gemini 模型,只需更新三行代码 并使用您的 Gemini API 密钥即可。如果您尚未使用 OpenAI 库,我们建议您直接调用 Gemini API

Python

from openai import OpenAI

client = OpenAI(
    api_key="GEMINI_API_KEY",
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

response = client.chat.completions.create(
    model="gemini-3.6-flash",
    messages=[
        {   "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "Explain to me how AI works"
        }
    ]
)

print(response.choices[0].message)

JavaScript

import OpenAI from "openai";

const openai = new OpenAI({
    apiKey: "GEMINI_API_KEY",
    baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/"
});

const response = await openai.chat.completions.create({
    model: "gemini-3.6-flash",
    messages: [
        {   role: "system",
            content: "You are a helpful assistant." 
        },
        {
            role: "user",
            content: "Explain to me how AI works",
        },
    ],
});

console.log(response.choices[0].message);

REST

curl "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $GEMINI_API_KEY" \
  -d '{
    "model": "gemini-3.6-flash",
    "messages": [
      {
        "role": "user",
        "content": "Explain to me how AI works"
      }
    ]
  }'

有何变化?只有三行!

  • api_key="GEMINI_API_KEY":将“GEMINI_API_KEY”替换为您的实际 Gemini API 密钥,您可以在Google AI Studio中获取该密钥。

  • base_url="https://generativelanguage.googleapis.com/v1beta/openai/": 这会告知 OpenAI 库将请求发送到 Gemini API 端点,而不是默认网址。

  • model="gemini-3.6-flash":选择兼容的 Gemini 模型

思考

Gemini 模型经过专门训练,能够思考复杂问题,从而大幅提升推理能力。Gemini API 附带 思考 参数,可用于精细 控制模型的思考量。

不同的 Gemini 模型具有不同的推理配置,您可以按如下方式查看它们如何映射到 OpenAI 的推理工作:

reasoning_effort (OpenAI) thinking_level (Gemini 3.1 Pro) thinking_level (Gemini 3.1 Flash-Lite) thinking_level (Gemini 3 Flash) thinking_budget (Gemini 2.5)
minimal low minimal minimal 1,024
low low low low 1,024
medium medium medium medium 8,192
high high high high 24,576

如果未指定 reasoning_effort,Gemini 会使用模型的 默认 级别预算