Nano Banana
以 Gemini 格式生成图片,支持单图和多图参考。
本系列支持的端点
- 香蕉(gemini原生格式同步)
POST https://zexapi.com/v1beta/models/{model}:generateContent
https://zexapi.com/v1beta/models/{model}:generateContent鉴权 Authorization: Bearer YOUR_API_KEY
使用 API Key 进行 Bearer 鉴权。JSON 请求设置 Content-Type: application/json;Multipart 请求由客户端自动生成 boundary。
inlineData与fileData可在同一请求的不同parts中混用。- 返回的图片链接请及时下载或转存。
图片生成接口文档
接口地址
POST /v1beta/models/{model}:generateContent功能说明
支持的模型
| model | 说明 |
|---|---|
gemini-3-pro-image | 同步与异步均支持;通过 generationConfig.imageConfig.imageSize 选择 1K / 2K / 4K |
gemini-3.1-flash-image | 同步与异步均支持;通过 generationConfig.imageConfig.imageSize 选择 1K / 2K / 4K |
gemini-nano-banana-2.1 | Gemini / 香蕉 2.1;同步与异步均支持;通过 generationConfig.imageConfig.imageSize 选择 1K / 2K / 4K |
nano_banana_2 | 同步与异步均支持;固定 1K,清晰度跟随型号 |
nano_banana_2-2K | 同步与异步均支持;固定 2K,清晰度跟随型号 |
nano_banana_2-4K | 同步与异步均支持;固定 4K,清晰度跟随型号 |
nano-banana-2.1 | 同步与异步均支持;固定 1K,清晰度跟随型号 |
nano-banana-2.1-2K | 同步与异步均支持;固定 2K,清晰度跟随型号 |
nano-banana-2.1-4K | 同步与异步均支持;固定 4K,清晰度跟随型号 |
nano_banana_pro-1K | 同步与异步均支持;固定 1K,清晰度跟随型号 |
nano_banana_pro-2K | 同步与异步均支持;固定 2K,清晰度跟随型号 |
nano_banana_pro-4K | 同步与异步均支持;固定 4K,清晰度跟随型号 |
POST /v1beta/models/gemini-3.1-flash-image:generateContent请求头
| 参数名 | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer YOUR_API_KEY |
Content-Type | 是 | application/json |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
contents | array | 是 | 对话内容列表 |
contents[].role | string | 是 | 固定填 "user" |
contents[].parts | array | 是 | 内容部件数组 |
contents[].parts[].text | string | 是 | 图片描述提示词 |
contents[].parts[].inlineData | object | 否 | 参考图片(Base64 方式),图生图时二选一 |
contents[].parts[].inlineData.mimeType | string | 是 | 图片格式,如 image/jpeg、image/png、image/webp |
contents[].parts[].inlineData.data | string | 是 | 图片的纯 Base64 字符串(不含 data:image/jpeg;base64, 前缀) |
contents[].parts[].fileData | object | 否 | 参考图片(URL 方式),图生图时二选一 |
contents[].parts[].fileData.mimeType | string | 否 | 图片格式,如 image/jpeg、image/png、image/webp,可省略 |
contents[].parts[].fileData.fileUri | string | 是 | 图片的 HTTP/HTTPS 直链地址 |
generationConfig | object | 否 | 生成配置 |
generationConfig.responseModalities | array | 否 | 返回内容模态,固定传 ["IMAGE"] |
generationConfig.imageConfig | object | 否 | 图片生成配置 |
generationConfig.imageConfig.aspectRatio | string | 否 | 输出图片宽高比,见下方支持列表 |
generationConfig.imageConfig.imageSize | string | 否 | 输出分辨率档位:1K / 2K / 4K |
response_format | string | 否 | 返回内容形态,见下方「返回 URL / Base64」 |
返回 URL / Base64(response_format)
| 传值 | 返回内容 |
|---|---|
| 不传(推荐) | 同时返回 URL 与 Base64 |
"url" | 只返回图片 URL |
"b64_json" | 只返回 Base64(纯字符串,不含 data: 前缀) |
支持的宽高比(aspectRatio)
1:1 2:3 3:2 3:4 4:3 4:5 5:4 9:16 16:9 21:9aspectRatio与imageSize:aspectRatio控制输出宽高比;imageSize(1K/2K/4K)控制分辨率档位。两者均为官方生成参数,实际成图像素由官方决定,不保证与固定数值一一对应。
文生图
curl -X POST https://xxx.com/v1beta/models/gemini-3.1-flash-image:generateContent \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "帮我做个广告"
}
]
}
],
"generationConfig": {
"responseModalities": ["IMAGE"],
"imageConfig": {
"aspectRatio": "21:9",
"imageSize": "2K"
}
}
}'图生图(单张参考图,Base64 方式)
{
"contents": [
{
"role": "user",
"parts": [
{
"inlineData": {
"mimeType": "image/jpeg",
"data": "/9j/4AAQSkZJRg..."
}
},
{
"text": "Change the background to a peaceful sunny beach, keep the main subject unchanged"
}
]
}
],
"generationConfig": {
"responseModalities": ["IMAGE"],
"imageConfig": {
"aspectRatio": "21:9",
"imageSize": "2K"
}
}
}图生图(单张参考图,URL 方式)
{
"contents": [
{
"role": "user",
"parts": [
{
"fileData": {
"mimeType": "image/jpeg",
"fileUri": "https://example.com/your-image.jpg"
}
},
{
"text": "Change the background to a peaceful sunny beach, keep the main subject unchanged"
}
]
}
],
"generationConfig": {
"responseModalities": ["IMAGE"],
"imageConfig": {
"aspectRatio": "21:9",
"imageSize": "2K"
}
}
}图生图(多张参考图)
{
"contents": [
{
"role": "user",
"parts": [
{
"inlineData": {
"mimeType": "image/jpeg",
"data": "/9j/4AAQSkZJRg..."
}
},
{
"inlineData": {
"mimeType": "image/png",
"data": "iVBORw0KGgoAAAANSU..."
}
},
{
"text": "Blend the style of both images and generate a new landscape"
}
]
}
],
"generationConfig": {
"responseModalities": ["IMAGE"]
}
}响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
created | number | 生成时间戳(Unix 秒) |
model | string | 使用的模型名 |
candidates | array | 结果列表 |
candidates[].content.parts[].image_url.url | string | 图片 URL(缺省或 "url" 时有) |
candidates[].content.parts[].inlineData.mimeType | string | 图片 MIME,如 image/png(缺省或 "b64_json" 时有) |
candidates[].content.parts[].inlineData.data | string | 纯 Base64 字符串,不含 data: 前缀(缺省或 "b64_json" 时有) |
candidates[].finishReason | string | 完成原因,正常为 "STOP" |
data | array | 便捷取参:data[0].url / data[0].b64_json |
缺省双给时: parts[0]为image_url,parts[1]为inlineData;只读 URL 的旧客户端可继续读parts[0].image_url.url,无需改动。
响应示例
缺省(同时返回 URL 与 Base64)
{
"created": 1780125491,
"model": "gemini-3.1-flash-image",
"candidates": [
{
"content": {
"parts": [
{
"image_url": {
"url": "https://cdn.example.com/output/xxx.png"
}
},
{
"inlineData": {
"mimeType": "image/png",
"data": "iVBORw0KGgoAAAANSU..."
}
}
]
},
"finishReason": "STOP"
}
],
"data": [
{
"url": "https://cdn.example.com/output/xxx.png",
"b64_json": "iVBORw0KGgoAAAANSU..."
}
]
}只要 URL(请求体加 "response_format": "url")
{
"created": 1780125491,
"model": "gemini-3.1-flash-image",
"candidates": [
{
"content": {
"parts": [
{
"image_url": {
"url": "https://cdn.example.com/output/xxx.png"
}
}
]
},
"finishReason": "STOP"
}
],
"data": [
{
"url": "https://cdn.example.com/output/xxx.png"
}
]
}只要 Base64(请求体加 "response_format": "b64_json")
{
"created": 1780125491,
"model": "gemini-3.1-flash-image",
"candidates": [
{
"content": {
"parts": [
{
"inlineData": {
"mimeType": "image/png",
"data": "iVBORw0KGgoAAAANSU..."
}
}
]
},
"finishReason": "STOP"
}
],
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSU..."
}
]
}{
"contents": [
{
"role": "user",
"parts": [{ "text": "A cute cat" }]
}
],
"response_format": "b64_json"
}提取图片
取 URL(缺省或 "url")
response.candidates[0].content.parts[0].image_url.urlresponse.data[0].url取 Base64(缺省或 "b64_json")
response.candidates[0].content.parts[1].inlineData.dataresponse.candidates[0].content.parts[0].inlineData.dataresponse.data[0].b64_jsondata:image/png;base64, + Base64 字符串。注意事项
parts 中必须包含 text 字段image/jpeg、image/png、image/webp,单张建议不超过 5MBinlineData(Base64)和 fileData(URL 直链)均可,同一请求中可混用;fileData 使用 fileUri 字段传入图片 HTTP/HTTPS 地址aspectRatio + imageSize 仅表示比例与档位意图,官方实际成图尺寸可能浮动,请勿按固定像素值预期response_format:不传 = URL + Base64 双给;"url" = 只要链接;"b64_json" = 只要 Base64。缺省双给时回包体积更大,若只需要链接请显式传 "url"让你的 AI 帮你接入
适用于能接收文字或读取文件的 Codex、Claude Code、WorkBuddy、AI 编辑器等。复制或下载当前接口资料,再交给你使用的 AI 工具完成接入。
真实调用需要令牌(API Key)。它是使用你账户额度的凭证,请勿粘贴到 AI 对话或公开分享。这里仅导出说明,AI 会指导你到配置位置自行填写。
第一次使用?令牌是什么,在哪里填写?
- 先获取令牌。登录你购买或开通接口的服务平台,在“令牌 / API Key / 密钥”页面创建;找不到入口时联系服务提供方。文档中的
YOUR_API_KEY是示例占位符。 - 把资料交给 AI,不要附上真实令牌。AI 会结合你的工具或项目,说明具体配置位置。工具支持专用凭据设置时优先在那里填写;其他情况按指引在本地或服务器配置,避免提交或公开。
- 配置后才能真实调用。只发文档不代表 AI 已获得调用权限或令牌。无法安全配置时,可以先使用示例响应验证,或在“接口文档”的调试台中自行测试。
本地文件和环境变量也可能被有读取权限的 AI 工具访问。如果你要求令牌不进入 AI 对话上下文,需要使用能隔离凭据并代为发送请求的可信工具,不能仅靠这份文档保证。
如果已经泄露,请到签发平台撤销旧令牌并重新生成;只删除聊天消息不够。
资料拿到后,怎么交给 AI?
第一次使用,选“复制给 AI”或“下载 Markdown 资料”其中一种即可,不需要同时操作,也不必安装 Skill。
方式一:复制给 AI(推荐)
- 点击上方“复制给 AI”,复制的是当前接口的接入资料。
- 打开你正在使用的 AI 工具,把资料粘贴到对话输入框中。
- 在资料后面补充你的需求,再发送。如果要修改已有项目,先在工具中打开项目,或提供相关文件。
方式二:下载 Markdown 资料
- 点击“下载 Markdown 资料”,得到一个
.md文件。它是文字资料,不需要运行。 - 在 AI 对话中把这个文件作为附件上传;如果使用能读取项目文件的 AI 工具,也可以把文件放到项目中,并告诉 AI 文件名和位置。
- 发送你的需求,并明确让 AI 先阅读这份资料。如果工具不能读取文件,用文本编辑器打开文件,将全部内容复制到对话中即可。
不知道怎么描述?把资料粘贴或添加文件后,可以接着这样说,并把括号里的内容换成自己的需求:
请先阅读我提供的接口资料,帮我实现【图片生成 / 视频生成等功能】,用于【我的项目或使用场景】。我不熟悉代码,请一步步说明。需要 API 令牌时,告诉我在哪里自行填写,不要让我把真实令牌发到对话里。先使用模拟数据验证,真实调用前告诉我可能产生的费用。
如果 AI 只能聊天,它可以提供步骤和代码;修改项目或执行请求,需要你使用的工具具备相应能力并获得你的授权。这里只提供资料,不会代你调用接口。文档更新后,请重新复制或下载最新资料。
反复接入时,怎样使用 Skill 包?(进阶,可跳过)
Skill 是让 AI 重复使用的一份工作说明,适合经常接入或维护接口的用户。首次使用直接复制资料或下载 Markdown 就够了。
- 点击“下载 Skill 包(进阶)”,解压 ZIP 文件,先阅读包内的
README.md。 - 如果你的工具支持 Skills,按该工具的说明导入完整的
api-integration-assistant目录,保留SKILL.md与references/integration.md的目录关系;不要只上传 ZIP 就默认已经安装成功。 - 在工具中确认技能已识别,再让 AI 使用这份技能,并说明你的接入需求。不同工具的安装方式和启用方式可能不同。
不确定工具是否支持?无需安装,直接把包内的 references/integration.md 交给 AI,使用方法与 Markdown 资料相同。包内不含执行脚本、用户令牌或上传素材,请勿覆盖已有项目指导文件。资料为固定版本 27,未明确的接口能力需要向服务提供方确认。
资料范围:当前页面可见文档。不会附带你在调试台填写的密钥或上传素材。普通开发者也可以直接使用完整接口文档。