Gemini 图像生成

Gemini 图像模型（Nano Banana）支持文生图、图片编辑和多轮修改。可以用 Gemini 原生接口调用，也可以用 OpenAI Chat Completions 格式调用。本页示例使用 gemini-3.1-flash-image，其他 Gemini 图像模型见模型广场。

调用方式	接口	图片返回位置
Gemini 原生（推荐）	`POST /v1beta/models/{model}:generateContent`	`parts[].inlineData.data`（Base64）
OpenAI 兼容	`POST /v1/chat/completions`	`message.content` 中的 Markdown 图片（Data URL）

文生图

cURL

Python

响应（Base64 已截断）：

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": { "mimeType": "image/jpeg", "data": "/9j/4AAQSkZJRgABAQEBLAEsAAD……" },
            "thoughtSignature": "……"
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 17,
    "candidatesTokenCount": 1470,
    "totalTokenCount": 1487,
    "candidatesTokensDetails": [{ "modality": "IMAGE", "tokenCount": 1120 }]
  },
  "modelVersion": "gemini-3.1-flash-image"
}

生成参数

字段	说明
`responseModalities`	`["TEXT", "IMAGE"]` 图文混合返回；`["IMAGE"]` 只返回图片
`imageConfig.aspectRatio`	宽高比，如 `1:1`、`16:9`、`9:16`、`4:3`、`3:4`
`imageConfig.imageSize`	分辨率档位，如 `1K`（实测 `16:9` + `1K` 输出 1376×768）

编辑图片

把原图放在 inlineData 中，与修改要求一起发送：

Python

HTTP 请求体

OpenAI 兼容格式

已有 OpenAI 代码时，可直接用 Chat Completions 调用。图片以 Markdown 形式返回在 content 中：![image](data:image/jpeg;base64,...)。

cURL

Python

响应（Base64 已截断）：

{
  "model": "gemini-3.1-flash-image",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "![image](data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD……)" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 276, "completion_tokens": 1526, "total_tokens": 1802 }
}

提示

OpenAI 兼容格式下，宽高比等要求写在提示词里即可（如「生成比例为 16:9」）；需要精确控制宽高比与分辨率时，使用 Gemini 原生格式的 imageConfig。

常见问题

只返回了文字，没有图片

响应很大

SDK 返回 404

文生图#

生成参数#

编辑图片#

OpenAI 兼容格式#

常见问题#

文生图

生成参数

编辑图片

OpenAI 兼容格式

常见问题