Gemini 原生生图 API：generateContent、Interactions 与图片解析

展开本页目录

开始前准备什么

选定真实可用模型 ID，并确认当前分组开放的是原生协议还是 Images 兼容适配。
核对供应商请求路径、鉴权方式、支持字段和响应示例，不能把 Google 的官方主机直接替换成 apizt 主机就视为支持。
准备授权 PNG 或 JPEG，保留真实 MIME、Base64 和原图元数据。
多轮编辑保存完整必要上下文；在公开模板里只放脱敏或人工构造的数据。

确认协议
核对字段
单图请求
逐块解析
保存与对照

仅为协议字段示意，含需替换的模型与图片占位符，不会调用 API；不证明 apizt 已支持其中任一原生协议。

先对照三种协议，别混用字段

截至资料核对日，Google 生图主指南示例以 Interactions 为主，generateContent 仍有独立协议参考。某个型号在目录中出现，不能单独证明全部协议和多轮行为都已开放；接入以自己当前通道的文档和一次实际响应为准。

协议	典型请求	典型结果位置
generateContent	contents[].parts；generationConfig	candidates[].content.parts，逐块识别文字与图片
Interactions	model、input、response_format	按 SDK output_image 或 steps 中的 image 内容读取
Images 兼容适配	model、prompt，参考图按对应 edits 规范	实际响应的 data[].b64_json 或受控 URL

协议: generateContent
典型请求: contents[].parts；generationConfig
典型结果位置: candidates[].content.parts，逐块识别文字与图片

协议: Interactions
典型请求: model、input、response_format
典型结果位置: 按 SDK output_image 或 steps 中的 image 内容读取

协议: Images 兼容适配
典型请求: model、prompt，参考图按对应 edits 规范
典型结果位置: 实际响应的 data[].b64_json 或受控 URL

Gemini 图像三条接口形态：contents[].parts、generationConfig、candidates、b64_json — 本站绘制的内容说明图：三种形态按本页协议表分开；不能将一个 SDK 的响应字段套到另一接口。
查看高清原图

generateContent：保留文字与图片的 parts 结构

这是原生结构示意，不包含可直接执行的 apizt 请求地址。responseModalities 与图片参数须核对所选型号，普通文字模型不因加入 IMAGE 就变成生图模型；尺寸、比例和多参考图上限也不能跨型号照搬。

generateContent 请求体字段示意：模型、路径与鉴权另行确认

json

{
  "contents": [{
    "role": "user",
    "parts": [
      { "text": "基于授权参考图，把背景改为浅灰摄影背景，保留杯子外形和数量。" },
      { "inlineData": { "mimeType": "image/png", "data": "REPLACE_WITH_ACTUAL_BASE64" } }
    ]
  }],
  "generationConfig": { "responseModalities": ["TEXT", "IMAGE"] }
}

Interactions：用自己的输出解析分支

Interactions 的 snake_case 与 generateContent 的 camelCase 不可直接混用。对交错图文输出，应遍历完整的输出内容并分别保存文本和图片；便捷属性可能只代表其中一部分。不要把中间思考图当成最终交付图。

Interactions 请求体字段示意：供应支持待核对

json

{
  "model": "REPLACE_WITH_CONFIRMED_IMAGE_MODEL",
  "input": [
    { "type": "text", "text": "生成一张无字蓝色陶瓷杯展示图，主体完整，干净摄影背景。" }
  ],
  "response_format": { "type": "image", "aspect_ratio": "1:1" }
}

收到 JSON 后，逐项确认最终图片

先检查 HTTP、拒绝或错误字段，再确定协议对应的候选、步骤或图片块；空候选应保留为无图响应。
generateContent 遍历 candidates 与 parts，只把实际含图片数据的 inlineData 作为图片输入；文字说明不能作为成功出图证明。
Interactions 按当前 SDK 和响应结构识别最终 model_output 内容，保留多张图片的顺序和关联，不强行取第一个未知字段。
每张结果验证真实 MIME 和字节，完整解码后记录实际宽高、文件大小与哈希；不以 1K、2K 标签替代实测像素。
多轮编辑按所用协议保存必要上下文和签名字段，不把两种接口的会话标识互相移用。

Gemini inlineData 的实际文件检查：inlineData、MIME、candidates、哈希 — 本站绘制的内容说明图：图说明本页响应解析边界；请求分辨率标签和模型文本回复都不是图片文件证据。
查看高清原图

核对最终图片的真实格式与尺寸

先做通道核对，再讨论模型优势

本页没有新增原生 API 实测，也没有证明 apizt 的 Interactions 供应。需要立即制作图片时，在创作工作台查看当前支持的模型；开发接入优先跑通明确有文档的协议，再扩展原生多轮能力。

要确认	需要的证据	没确认时
原生路径与认证	当前接入文档和实际响应	保持待核对，不猜测地址
参考图与多轮编辑	一张授权输入、明确任务和返回文件	先用单轮候选，不承诺连续编辑
比例和尺寸	接受的字段与输出实际宽高	只采用已确认参数
价格与费用	模型广场和自己的调用账单	估算与实际扣费分开记录

要确认: 原生路径与认证
需要的证据: 当前接入文档和实际响应
没确认时: 保持待核对，不猜测地址

要确认: 参考图与多轮编辑
需要的证据: 一张授权输入、明确任务和返回文件
没确认时: 先用单轮候选，不承诺连续编辑

要确认: 比例和尺寸
需要的证据: 接受的字段与输出实际宽高
没确认时: 只采用已确认参数

要确认: 价格与费用
需要的证据: 模型广场和自己的调用账单
没确认时: 估算与实际扣费分开记录

怎样确认已经完成

路径、鉴权、协议与模型来自同一套当前接入说明。
没有把 Images、generateContent 和 Interactions 字段混用。
已区分文字响应、思考图与最终图片。
每张保存图片的实际格式、宽高和顺序可查。
通道未证实的功能保持待核对，费用没有从宣传资料推断。

常见问题

Nano Banana 的模型名相同就能换协议吗？

不能。型号、供应路径和适配层是不同条件。先核对当前服务具体开放的协议，再用对应字段及响应解析。

Gemini 原生和 OpenAI Images 哪个更好？

先看你需要的参考图、图文交错或多轮功能，以及当前通道实际支持。只需要一次出图时，已验证的兼容接口通常更容易接入；原生功能应逐项确认。

资料来源

展开本页目录

开始前准备什么

选定真实可用模型 ID，并确认当前分组开放的是原生协议还是 Images 兼容适配。
核对供应商请求路径、鉴权方式、支持字段和响应示例，不能把 Google 的官方主机直接替换成 apizt 主机就视为支持。
准备授权 PNG 或 JPEG，保留真实 MIME、Base64 和原图元数据。
多轮编辑保存完整必要上下文；在公开模板里只放脱敏或人工构造的数据。

确认协议
核对字段
单图请求
逐块解析
保存与对照

下载两种协议结构对照

仅为协议字段示意，含需替换的模型与图片占位符，不会调用 API；不证明 apizt 已支持其中任一原生协议。

先对照三种协议，别混用字段

协议	典型请求	典型结果位置
generateContent	contents[].parts；generationConfig	candidates[].content.parts，逐块识别文字与图片
Interactions	model、input、response_format	按 SDK output_image 或 steps 中的 image 内容读取
Images 兼容适配	model、prompt，参考图按对应 edits 规范	实际响应的 data[].b64_json 或受控 URL

协议: generateContent
典型请求: contents[].parts；generationConfig
典型结果位置: candidates[].content.parts，逐块识别文字与图片

协议: Interactions
典型请求: model、input、response_format
典型结果位置: 按 SDK output_image 或 steps 中的 image 内容读取

协议: Images 兼容适配
典型请求: model、prompt，参考图按对应 edits 规范
典型结果位置: 实际响应的 data[].b64_json 或受控 URL

generateContent：保留文字与图片的 parts 结构

generateContent 请求体字段示意：模型、路径与鉴权另行确认

json

{
  "contents": [{
    "role": "user",
    "parts": [
      { "text": "基于授权参考图，把背景改为浅灰摄影背景，保留杯子外形和数量。" },
      { "inlineData": { "mimeType": "image/png", "data": "REPLACE_WITH_ACTUAL_BASE64" } }
    ]
  }],
  "generationConfig": { "responseModalities": ["TEXT", "IMAGE"] }
}

Interactions：用自己的输出解析分支

Interactions 请求体字段示意：供应支持待核对

json

{
  "model": "REPLACE_WITH_CONFIRMED_IMAGE_MODEL",
  "input": [
    { "type": "text", "text": "生成一张无字蓝色陶瓷杯展示图，主体完整，干净摄影背景。" }
  ],
  "response_format": { "type": "image", "aspect_ratio": "1:1" }
}

收到 JSON 后，逐项确认最终图片

先检查 HTTP、拒绝或错误字段，再确定协议对应的候选、步骤或图片块；空候选应保留为无图响应。
generateContent 遍历 candidates 与 parts，只把实际含图片数据的 inlineData 作为图片输入；文字说明不能作为成功出图证明。
Interactions 按当前 SDK 和响应结构识别最终 model_output 内容，保留多张图片的顺序和关联，不强行取第一个未知字段。
每张结果验证真实 MIME 和字节，完整解码后记录实际宽高、文件大小与哈希；不以 1K、2K 标签替代实测像素。
多轮编辑按所用协议保存必要上下文和签名字段，不把两种接口的会话标识互相移用。

核对最终图片的真实格式与尺寸

先做通道核对，再讨论模型优势

要确认	需要的证据	没确认时
原生路径与认证	当前接入文档和实际响应	保持待核对，不猜测地址
参考图与多轮编辑	一张授权输入、明确任务和返回文件	先用单轮候选，不承诺连续编辑
比例和尺寸	接受的字段与输出实际宽高	只采用已确认参数
价格与费用	模型广场和自己的调用账单	估算与实际扣费分开记录

要确认: 原生路径与认证
需要的证据: 当前接入文档和实际响应
没确认时: 保持待核对，不猜测地址

要确认: 参考图与多轮编辑
需要的证据: 一张授权输入、明确任务和返回文件
没确认时: 先用单轮候选，不承诺连续编辑

要确认: 比例和尺寸
需要的证据: 接受的字段与输出实际宽高
没确认时: 只采用已确认参数

要确认: 价格与费用
需要的证据: 模型广场和自己的调用账单
没确认时: 估算与实际扣费分开记录

怎样确认已经完成

路径、鉴权、协议与模型来自同一套当前接入说明。
没有把 Images、generateContent 和 Interactions 字段混用。
已区分文字响应、思考图与最终图片。
每张保存图片的实际格式、宽高和顺序可查。
通道未证实的功能保持待核对，费用没有从宣传资料推断。

常见问题

Nano Banana 的模型名相同就能换协议吗？

不能。型号、供应路径和适配层是不同条件。先核对当前服务具体开放的协议，再用对应字段及响应解析。

Gemini 原生和 OpenAI Images 哪个更好？

先看你需要的参考图、图文交错或多轮功能，以及当前通道实际支持。只需要一次出图时，已验证的兼容接口通常更容易接入；原生功能应逐项确认。

Gemini 原生生图 API：generateContent、Interactions 与图片解析

先看结论

开始前准备什么

先对照三种协议，别混用字段

generateContent：保留文字与图片的 parts 结构

Interactions：用自己的输出解析分支

收到 JSON 后，逐项确认最终图片

先做通道核对，再讨论模型优势

怎样确认已经完成

常见问题

资料来源

全球顶尖大模型 · 一站式接入

创建 API Key

填写接入配置

发起第一次调用

Gemini 原生生图 API：generateContent、Interactions 与图片解析

先看结论

开始前准备什么

先对照三种协议，别混用字段

generateContent：保留文字与图片的 parts 结构

Interactions：用自己的输出解析分支

收到 JSON 后，逐项确认最终图片

先做通道核对，再讨论模型优势

怎样确认已经完成

常见问题

资料来源

全球顶尖大模型 · 一站式接入

创建 API Key

填写接入配置

发起第一次调用