跳到主要内容

Gemini

注意

本教程为社区贡献内容，不属于 OPL 数据空间团队的官方支持范围。它主要演示如何按你的具体场景定制 OPL 数据空间。若想参与贡献，请查看贡献指南。

OPL 数据空间也支持通过 Google AI Studio API（也就是常说的 Gemini API）进行图像生成。

提示

在启用了 organizations 的部署中，图像设置可能来自当前选中的组织，而不仅仅是实例默认值。更新 Gemini 的 key 或 base URL 前，先确认当前 admin scope。

初始设置​

  1. 从 Google AI Studio 获取 API key，或者在 Google Cloud 中创建 API Key，并为项目启用 Generative Language API。
  2. 大多数情况下，你还需要创建项目、启用 Generative Language API，并配置计费信息，因为图像生成接口通常不是免费开放的。
注意

如果你使用的是免费 API Key，务必确保账户已经绑定可用的支付方式。缺少有效支付方式是接入失败的常见原因。

提示

如果你使用的是 Vertex AI，也可以在 Google Cloud 中创建 API Key，而不一定非要用 service account。只要为该 key 赋予正确权限，并确保项目已启用 Generative Language API，它同样可以工作。

配置 OPL 数据空间​

  1. 在 OPL 数据空间中进入 管理员面板 > 设置 > Images。
  2. 将 Image Generation Engine 设置为 Gemini。
  3. 将 API Base URL 设置为 https://generativelanguage.googleapis.com/v1beta。
  4. 填入你的 Google AI Studio API key。
  5. 填写你要使用的模型，可参考这些可用模型。
  6. 选择可用的图像尺寸。

最小示例配置​

Create Image

  • Create Image Model: gemini-3-pro-image-preview
  • Image Size: 2816x1536
  • Image Prompt Generation: 开启
  • Image Generation Engine: Gemini
  • Gemini Base URL: https://generativelanguage.googleapis.com/v1beta
  • Gemini API Key: 填入你的 API Key
  • Gemini Endpoint Method: generateContent

Edit Image

Screenshot of the OPL 数据空间 Images settings page with Gemini selected and the API key, model, and image size fields highlighted.

信息

当前这个能力通常只对支持以下端点的方法有效：https://generativelanguage.googleapis.com/v1beta/models/<MODEL_NAME>:predict。
这是 Google 提供的 OpenAI 兼容 BETA 端点，主要用于实验性兼容。

Google Imagen 模型使用这个 :predict 端点，而 Gemini 图像模型使用的是另一个以 :generateContent 结尾的端点。

Imagen 模型端点示例：

  • https://generativelanguage.googleapis.com/v1beta/models/imagen-4.0-generate-001:predict
  • Imagen 模型文档

Gemini 模型端点示例：

  • https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent
  • Gemini 图像生成文档

如果你尝试用 predict 去调用 gemini-3-pro-image-preview 这类 Gemini 模型，就会因为端点不匹配而报错：

400: [ERROR: models/gemini-3-pro-image-preview is not found for API version v1beta, or is not supported for predict. Call ListModels to see the list of available models and their supported methods.]

通过 LiteLLM 代理 Gemini 端点​

OPL 数据空间支持通过 LiteLLM 代理使用 Gemini 或 Imagen 端点进行图像生成。可按下面方式配置：

  1. 在 OPL 数据空间中进入 管理员面板 > 设置 > Images。
  2. 将 Image Generation Engine 设置为 Open AI。
  3. 将 API endpoint URL 改为 https://<your-litellm-url>:<port>/v1。
  4. 填入你的 LiteLLM API Key。
  5. API version 可留空。
  6. 填入与你 LiteLLM 配置中一致的图像模型名称。
  7. 将图像尺寸设置为该模型支持的范围之一。
提示

如需查找 LiteLLM 的连接信息，可进入 管理员面板 > 设置 > Connections。
Gemini API 连接会显示在该页面中。