Skip to main content
更新日期:2026-06-06

Gemini OpenAI 兼容格式

你可以通过 OpenAI Chat Completions 兼容格式调用 Gemini。
本文页只写入 2026-03-22 已在 Crazyrouter 生产环境复核过的兼容层行为。 当前主示例模型:
  • gemini-3.1-pro

当前主结论

本轮生产复核确认:
  • gemini-3.1-pro 可以通过 /v1/chat/completions 正常对话
  • 流式返回兼容 chat.completion.chunk SSE 结构
  • 如果你需要 Gemini 的结构化输出、Google Search、thinking 等能力,当前仍应优先看 Gemini 原生格式

基本对话

cURL
当前生产验证返回的关键结构:

Python 示例

Python

流式输出

本轮生产也复核了流式兼容返回:
Python
当前生产收到的 SSE 片段形态类似:

何时用兼容格式,何时用原生格式

  • 已有 OpenAI SDK 代码,且只需要标准对话:优先用兼容格式
  • 需要 Gemini 的结构化输出、Google Search、thinking、原生字段:优先用 Gemini 原生格式
这页只覆盖 /v1/chat/completions 兼容层。对于 Gemini 图片工作负载,请使用统一 Images API:POST https://api.crazyrouter.com/v1/images/generations,并参考 Nano BananaNano Banana ProNano Banana 2