Gemini 生图

Gemini 系列生图模型（包含香蕉系列模型）采用 Google Gemini 原生 generateContent 接口协议。模型名称直接拼接在请求 URL 路径中，不属于 JSON 请求体。

接口基础信息

线路地址：https://img.mzfe.de（优化线路）或 https://img.zikl.dev（标准线路）
请求头：
- x-goog-api-key: <API_KEY>（原生推荐）
- 或 Authorization: Bearer <API_KEY>（兼容模式）
- Content-Type: application/json

模型与版本

别名	模型名 (Model)	所属分组	特点与取向
香蕉 Pro	`gemini-3-pro-image-preview`	`Gemini` / `福利gemini`	画质档，适合精细成品与高质量艺术创作
香蕉2	`gemini-3.1-flash-image-preview`	`Gemini` / `福利gemini`	速度档，生成速度快；额外支持超宽/超长比例（8:1、4:1、1:4、1:8）
Nano Banana 2.1	`gemini-nano-banana-2.1`	`福利gemini` / `Gemini`	轻量升级档，出图快、细节丰富，兼顾 Gemini 原生与 OpenAI 端点
Omni Flash	`omni-flash`	`Gemini`	多模态极速档，适合快速草图与批量灵感测试

gemini-nano-banana-2.1 调用说明

Gemini 原生协议：在请求路径中直接指定模型，如 /v1beta/models/gemini-nano-banana-2.1:generateContent。
OpenAI 兼容端点：在支持标准 OpenAI 生图端点的客户端中，亦可将模型名称设置为 gemini-nano-banana-2.1 进行调用。

比例与输出分辨率对照

输出比例	1K 分辨率	2K 分辨率	4K 分辨率
1:1	1024 × 1024	2048 × 2048	4096 × 4096
16:9	1376 × 768	2752 × 1536	5504 × 3072
9:16	768 × 1376	1536 × 2752	3072 × 5504
4:3	1200 × 896	2400 × 1792	4800 × 3584
3:4	896 × 1200	1792 × 2400	3584 × 4800
3:2	1264 × 848	2528 × 1696	5056 × 3392
2:3	848 × 1264	1696 × 2528	3392 × 5056
5:4	1152 × 928	2304 × 1856	4608 × 3712
4:5	928 × 1152	1856 × 2304	3712 × 4608
21:9	1584 × 672	3168 × 1344	6336 × 2688

香蕉2 超宽/超长条支持

仅 香蕉2 (gemini-3.1-flash-image-preview) 额外支持以下超宽与超长比例：

1K 档位：
- 8:1 = 2928 × 352
- 4:1 = 2064 × 512
- 1:4 = 512 × 2064
- 1:8 = 352 × 2928
2K / 4K 档位：分别按上述分辨率 ×2 / ×4。

03 文生图

在请求网址中指定具体的模型名称，并在 contents 的文字部件（parts）中填写生成提示词。

请求方式：POST
请求路径：/v1beta/models/{model}:generateContent
（例如：/v1beta/models/gemini-3-pro-image-preview:generateContent 或 /v1beta/models/gemini-nano-banana-2.1:generateContent）
Content-Type：application/json

请求参数

参数	必填	类型	说明
`contents[].role`	是	string	固定填写 `user`
`contents[].parts[].text`	是	string	文字提示词，中英文皆可
`generationConfig.responseModalities`	否	array	返回格式控制： • `["IMAGE"]` 返回 Base64 图片编码（默认） • `["TEXT"]` 返回公网直链网址 • `["IMAGE","TEXT"]` 两者同时返回
`generationConfig.imageConfig.aspectRatio`	否	string	输出比例（如 `"1:1"`、`"16:9"` 等）。若需模型自动决定比例，请直接省略该字段，不要传 `"auto"`
`generationConfig.imageConfig.imageSize`	否	string	输出规格：`"1K"`、`"2K"`、`"4K"`（字母 K 必须大写）

请求示例

bash

curl -X POST "https://img.mzfe.de/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "木桌上的红苹果,棚拍光线,极简背景" }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "1:1",
        "imageSize": "1K"
      }
    }
  }'

切换模型示例（以 gemini-nano-banana-2.1 为例）

如需使用 gemini-nano-banana-2.1 生成，只需将请求 URL 中的模型名称替换即可：

bash

curl -X POST "https://img.mzfe.de/v1beta/models/gemini-nano-banana-2.1:generateContent" \
  -H "x-goog-api-key: <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "赛博朋克风格未来城市，霓虹雨夜，细腻光影" }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "1K"
      }
    }
  }'

响应字段对照

`responseModalities` 设置	图片数据所在响应字段
`["IMAGE"]`	`candidates[0].content.parts[0].inline_data.data`
`["TEXT"]`	`candidates[0].content.parts[1].file_data.file_uri`
`["IMAGE","TEXT"]`	上述两个字段均会返回

同时返回 Base64 编码与网址响应示例

json

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inline_data": {
              "mime_type": "image/png",
              "data": "<BASE64>"
            }
          },
          {
            "file_data": {
              "file_uri": "https://xxx.png"
            }
          }
        ]
      }
    }
  ]
}

04 图生图

在 contents[].parts 中除了文字描述外，加入一个或多个图片部件。支持传入 Base64 图片编码或公网图片直链，也支持混合输入。

请求方式：POST
请求路径：/v1beta/models/{model}:generateContent
（例如：/v1beta/models/gemini-3-pro-image-preview:generateContent 或 /v1beta/models/gemini-nano-banana-2.1:generateContent）
Content-Type：application/json

请求参数

参数	必填	类型	说明
`contents[].role`	是	string	固定填写 `user`
`contents[].parts[].text`	是	string	编辑要求与修改指令
`contents[].parts[].inline_data`	二选一	object	传入图片 Base64 编码，包含 `mime_type` 与 `data`
`contents[].parts[].file_data`	二选一	object	传入公网图片直链，包含 `mime_type` 与 `file_uri`
`generationConfig.responseModalities`	否	array	`["IMAGE"]`、`["TEXT"]` 或 `["IMAGE","TEXT"]`
`generationConfig.imageConfig.aspectRatio`	否	string	省略时根据参考图自动决定；不要传 `"auto"`
`generationConfig.imageConfig.imageSize`	否	string	`"1K"` / `"2K"` / `"4K"`

多参考图提示

多个 inline_data 与 file_data 可以混用，模型会按它们在 contents[].parts 中的前后顺序进行理解和处理。

请求示例

1. 传入 Base64 图片编码

bash

curl -X POST "https://img.mzfe.de/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "改成日系水彩风,保留主体和构图" },
          {
            "inline_data": {
              "mime_type": "image/png",
              "data": "<BASE64>"
            }
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {
        "imageSize": "2K"
      }
    }
  }'

2. 传入公网图片直链

将上述请求中的 inline_data 部件替换为：

json

{
  "file_data": {
    "mime_type": "image/png",
    "file_uri": "https://example.com/input.png"
  }
}

尺寸与比例说明

只传 imageSize 并省略 aspectRatio 时，输出图像将自动跟随参考图比例；若两者均省略，比例与清晰度档位均交给上游模型智能决定。

Gemini 生图 ​

模型与版本 ​

比例与输出分辨率对照 ​

03 文生图 ​

请求参数 ​

请求示例 ​

响应字段对照 ​

同时返回 Base64 编码与网址响应示例 ​

04 图生图 ​

请求参数 ​

请求示例 ​

1. 传入 Base64 图片编码 ​

2. 传入公网图片直链 ​

Gemini 生图

模型与版本

比例与输出分辨率对照

03 文生图

请求参数

请求示例

响应字段对照

同时返回 Base64 编码与网址响应示例

04 图生图

请求参数

请求示例

1. 传入 Base64 图片编码

2. 传入公网图片直链