图像系列

Gemini 图片模型

以 Markdown 格式查看

Gemini 图片模型使用带有兼容 Generate Content 的请求体的图片生成端点。通用图片生成使用 gemini-3.1-flash-image，专业视觉素材使用 gemini-3-pro-image，现有 Nano Banana 工作流使用 gemini-2.5-flash-image。

curl https://api.getopenmodels.com/v1/images \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OM_API_KEY" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "route": { "provider": "<provider-for-this-model>" },
    "route_mode": "balanced",
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "Generate an image of a Chinese Li Hua cat in a modern studio product-photo style."
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "responseFormat": {
        "image": {
          "aspectRatio": "16:9",
          "imageSize": "2K"
        }
      }
    }
  }'

对于 Gemini 图片模型，请在 generationConfig 中设置图片生成选项。

字段类型备注
modelstring支持的值：gemini-3-pro-image、gemini-3.1-flash-image、gemini-2.5-flash-image。
contentsarray必填的 Generate Content 输入。使用带有 parts 的用户消息来传入文本提示词和可选图片输入。
contents[].parts[].textstring描述要生成或编辑图片的文本提示词。
contents[].parts[].inline_dataobject参考图或图片编辑工作流的可选图片输入。设置 mime_type 和 base64 data。
generationConfig.responseModalitiesarray输出模态。当你希望同时获得文本和图片部分时使用 ["TEXT", "IMAGE"]，只要图片输出时使用 ["IMAGE"]。
generationConfig.responseFormat.image.aspectRatiostring输出宽高比。常用值包括 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9。gemini-3.1-flash-image 也支持更宽比例，例如 1:4、4:1、1:8 和 8:1。
generationConfig.responseFormat.image.imageSizestringgemini-3-pro-image 和 gemini-3.1-flash-image 的输出大小。有效值包括 1K、2K 和 4K；gemini-3.1-flash-image 还支持 512。对 gemini-2.5-flash-image 请省略此字段。
tools[].google_searchobject当提示词需要当前或事实性网页信息时，Gemini 3 图片模型可使用的可选 grounding 工具。

Gemini 图片模型也支持兼容 OpenAI 的多模态聊天消息。当你的客户端通过 messages[].content[] 发送图片输入时，请使用此结构：

curl https://api.getopenmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $OM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.1-flash-image",
    "route": { "provider": "<provider-for-this-model>" },
    "route_mode": "balanced",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "What is in this image?"
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "https://live.staticflickr.com/3851/14825276609_098cac593d_b.jpg"
            }
          }
        ]
      }
    ]
  }'