跳转到主要内容
POST
文生图:根据文本描述生成图片
右侧的交互式 Playground 支持下拉选择参数(宽高比、响应类型等)。请在 Authorization 中填入你的 API Key(格式:Bearer sk-xxx),即可一键发送请求测试。
场景说明:本页用于「文本生成图片」。只需输入提示词即可,无需上传任何图片。如需根据现有图片做编辑,请使用 图片编辑接口
🖥️ 浏览器 Playground 限制(重要)本接口的响应里包含 base64 编码的图片(inlineData.data,数 MB 量级)。受浏览器渲染限制,右侧 Playground 在收到响应后可能弹出 请求时发生错误: unable to complete request ——实际请求已经成功,只是浏览器无法把这么长的 base64 显示出来。推荐做法(小白零踩坑):
  • 直接复制下方”代码示例”中的 Python / Node.js / cURL 到本地运行,代码会自动 base64.b64decode 并把图片保存为本地文件
  • Nano Banana 2 Lite 专注 1K 画布,响应体量适中,但仍建议本地运行以稳妥保存图片。
图片 API 全部为同步调用:没有异步任务 ID,客户端断开连接结果即丢失、但请求仍会计费。请为本模型设置足够大的 timeout,详见 图片 API 调用须知与最佳实践

代码示例

Python

cURL

Node.js

OpenAI 兼容模式

参数说明速查

详细的参数文档、可选值和默认值请查看右侧 Playground 中的字段说明,所有 enum 类型字段(如 aspectRatio)都支持下拉选择,无需手动输入。
从 Nano Banana 2 迁移:只需把模型名从 gemini-3.1-flash-image 改为 gemini-3.1-flash-lite-image,其它参数保持不变。注意 Lite 仅支持 1K 分辨率,如传入 2K/4K 请改回 1K

授权

Authorization
string
header
必填

在 API易控制台获取的 API Key

请求体

application/json
contents
object[]
必填

内容数组,包含文本提示词

generationConfig
object
必填

响应

成功生成图片

candidates
object[]

生成结果数组

usageMetadata
object