gemini-3-pro-image API

使用精确模型 ID gemini-3-pro-image。请求中的模型名必须与本页完全一致。

示例输出gemini-3-pro-imagePOST /v1beta/models/gemini-3-pro-image:generateContent

请求参数：size=2Kratio=16:9

提示词：Photoreal interior photograph of a sunlit Scandinavian living room: pale oak floor, linen sofa, a large window with sheer curtains, a single olive tree in a clay pot, morning light casting long soft shadows, no text.

生成该示例的请求

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Photoreal interior photograph of a sunlit Scandinavian living room: pale oak floor, linen sofa, a large window with sheer curtains, a single olive tree in a clay pot, morning light casting long soft shadows, no text."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K"
    }
  }
}

认证与入口

使用 Modelflare API Key，通过 https://modelflare.dev 发送请求。网关入口为 POST /v1/models/{model}:generateContent。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

生成请求

bash

curl "https://modelflare.dev/v1/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "一只白猫在雨夜霓虹街道上奔跑"}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}}
  }'

请求要点

Gemini 图片模型使用原生 contents 和 generationConfig；编辑时在同一 parts[] 中发送文字指令与 inline_data。

请求参数

Gemini 图片模型使用原生 Gemini generateContent。文本和参考图片都放在同一个 contents[].parts[] 中，图片以 inline_data 提供。不要把这些模型发到 /v1/images/generations、/v1/images/edits 或 OpenAI /v1/responses。不同 Gemini 图片行的 imageSize 枚举以本页表格为准。

字段	必填	说明
contents[].parts[].text	是	文字提示或编辑指令
contents[].parts[].inline_data	否	Base64 图片及 MIME 类型
contents[].parts[].inline_data.mime_type	否	image/jpeg / image/png / image/webp
contents[].parts[].inline_data.data	否	Base64 编码的参考图内容
generationConfig.responseModalities	是	["IMAGE"] 或 ["TEXT", "IMAGE"]
generationConfig.imageConfig.aspectRatio	否	1:1 / 4:3 / 3:4 / 16:9 / 9:16
generationConfig.imageConfig.imageSize	否	1K / 2K / 4K

响应与输入限制

Pro 支持 1K、2K、4K，比例为 1:1、4:3、3:4、16:9、9:16。官方文档没有公布参考图数量上限，因此网关不设置额外的本地上限。

图片编辑示例

编辑请求把文字指令和参考图放在同一个 contents[].parts[] 中。inline_data.data 使用 Base64 图片内容；不要把 Gemini 图片模型改发到 OpenAI Images 或 Responses 入口。

bash

curl "https://modelflare.dev/v1/models/gemini-3-pro-image:generateContent" \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [
      {"text": "保留主体和光线，把背景改成一片雾中的松林。"},
      {"inline_data": {"mime_type": "image/jpeg", "data": "BASE64_IMAGE_DATA"}}
    ]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"], "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}}
  }'

响应结构

读取 candidates[].content.parts[]，不要假设每个 part 都是图片；响应可能同时包含文字和图片。

字段	说明
candidates[].content.parts[].inline_data	生成图片的 MIME 类型和 Base64 数据
candidates[].content.parts[].text	模型返回的文字说明（如果请求了 TEXT）
candidates[].finishReason	完成或安全策略原因
usageMetadata	输入/输出 token 用量（服务端返回时）

Modelflare 保留 gemini-3-pro-image 的原生 Gemini 响应结构，并从图片 part 持久化可用的图片结果。

错误与失败任务

Gemini 原生请求的字段错误、尺寸/比例限制和安全拒绝会以 Gemini 兼容错误响应返回。网关不会把它改写成 OpenAI Images 响应。

支持范围

本页只覆盖 Modelflare 的模型生成/编辑调用。搜索或地图增强、声音管理、元素库管理等资源型接口不属于本页的公开调用范围，也不需要作为模型请求字段传入。

价格与计费

本模型按 Token 计费。请查看模型价格页查看当前销售价、参考原价和完整规格。

注意

本页只说明 Modelflare 的公开接口；可用字段和限制以本页当前版本为准。