Nano Banana
异步生成或编辑 Nano Banana 图片,支持多张参考图。
本系列支持的端点
- 香蕉(异步)
POST https://zexapi.com/v1/videos
https://zexapi.com/v1/videos鉴权 Authorization: Bearer YOUR_API_KEY
使用 API Key 进行 Bearer 鉴权。JSON 请求设置 Content-Type: application/json;Multipart 请求由客户端自动生成 boundary。
图片生成接口文档
接口地址
POST /v1/videos功能说明
model 参数区分)。支持的模型
| model 参数 | 说明 |
|---|---|
gemini-3-pro-image | 同步与异步均支持;通过 image_size 选择 1K / 2K / 4K |
gemini-3.1-flash-image | 同步与异步均支持;通过 image_size 选择 1K / 2K / 4K |
gemini-nano-banana-2.1 | Gemini / 香蕉 2.1;同步与异步均支持;通过 image_size 选择 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,清晰度跟随型号 |
请求头
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer YOUR_API_KEY |
| Content-Type | string | 是 | application/json |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称,如 nano_banana_2、nano-banana-2.1、gemini-nano-banana-2.1、nano_banana_pro-1K 等 |
| prompt | string | 是 | 文本提示词,最大长度 10000 字符 |
| aspect_ratio | string | 否 | 宽高比,可选值:1:1、9:16、16:9、3:4、4:3、3:2、2:3、5:4、4:5、21:9、auto,默认 auto |
| image_size | string | 否 | 输出分辨率档位。参数选档型号支持 1K、2K、4K;不传时使用模型默认值 |
| images | string[] | 否 | 参考图片数组(支持 Base64 或 URL),最多 8 张。传此参数为图生图模式,不传或传空数组为文生图模式 |
分辨率控制
| 模型 | 分辨率控制方式 |
|---|---|
gemini-nano-banana-2.1 | 使用顶层 image_size 字段,可选 1K、2K、4K |
nano-banana-2.1 / -2K / -4K | 分辨率由模型名决定:nano-banana-2.1 为 1K,nano-banana-2.1-2K、nano-banana-2.1-4K 为对应分辨率,不需要传 image_size |
nano_banana_pro-1K / -2K / -4K | 分辨率由模型名后缀决定,不需要传 image_size |
nano_banana_2 / -2K / -4K | nano_banana_2 使用模型默认分辨率;-2K、-4K 由模型名后缀决定,不需要传 image_size |
images 数组元素传法
| 方式 | 示例 |
|---|---|
| 图片 URL | "https://example.com/reference.jpg" |
| Base64 | "data:image/jpeg;base64,/9j/4AAQSkZJRg..." |
注意:传入图片 URL 时,网关会自动将其下载并转为 Base64 后发给上游,请确保 URL 为可公网访问的图片直链。
请求示例
Nano Banana 2.1 文生图(固定分辨率)
nano-banana-2.1 固定输出 1K。需要 2K 或 4K 时,把 model 换成 nano-banana-2.1-2K 或 nano-banana-2.1-4K,不要传 image_size。curl -X POST https://xxxxx.com/v1/videos \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2.1-4K",
"prompt": "高级护肤品广告,透明玻璃瓶放在水面上,柔和棚拍光线",
"aspect_ratio": "16:9"
}'gemini-nano-banana-2.1 文生图(参数选档,4K)
gemini-nano-banana-2.1 用同一个模型名,通过 image_size 选择 1K、2K、4K。curl -X POST https://xxxxx.com/v1/videos \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-nano-banana-2.1",
"prompt": "高级护肤品广告,透明玻璃瓶放在水面上,柔和棚拍光线",
"aspect_ratio": "16:9",
"image_size": "4K"
}'image_size 改为 "1K" 或 "2K"。文生图模式
curl -X POST https://xxxxx.com/v1/videos \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano_banana_2",
"prompt": "美丽的日出风景,金色的阳光洒在宁静的湖面上,远处是连绵的山脉",
"aspect_ratio": "16:9"
}'{
"model": "nano_banana_2",
"prompt": "美丽的日出风景,金色的阳光洒在宁静的湖面上,远处是连绵的山脉",
"aspect_ratio": "16:9"
}图生图模式(URL 格式)
curl -X POST https://xxxxx.com/v1/videos \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano_banana_2",
"prompt": "将这张图片转换成油画风格",
"aspect_ratio": "16:9",
"images": [
"https://example.com/images/reference1.jpg",
"https://example.com/images/reference2.png"
]
}'{
"model": "nano_banana_2",
"prompt": "美丽的日出风景,金色的阳光洒在宁静的湖面上,远处是连绵的山脉",
"aspect_ratio": "16:9",
"images": [
"https://xxxxxxxx.jpg",
"https://xxxxxxxx.png"
]
}图生图模式(Base64 格式)
curl -X POST https://xxxxx.com/v1/videos \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nano_banana_2",
"prompt": "将这张图片转换成油画风格",
"aspect_ratio": "16:9",
"images": [
"data:image/jpeg;base64,/9j/4AAQSkZJRg...",
"data:image/png;base64,iVBORw0KGgoAAAANSU..."
]
}'响应参数
/v1/videos,object 固定为 "video"。完成态图片地址位于顶层 url 和 image_url,两者值相同。| 参数名 | 类型 | 说明 |
|---|---|---|
| id | string | 任务 ID,格式:task_nano_xxx 或 task_xxx |
| object | string | 固定值:video(图片任务也是,类型看 model) |
| model | string | 使用的模型名称 |
| status | string | 任务状态:queued(排队中)、in_progress(处理中)、completed(已完成)、failed(失败) |
| progress | number | 任务进度,0–100 |
| created_at | number | 创建时间戳(秒) |
| completed_at | number | 完成时间戳(秒),仅在 failed 或 completed 状态返回 |
| url | string | 生成的图片 URL(仅 completed) |
| image_url | string | 与 url 同值(仅 completed) |
| error | object | 错误信息(仅在 failed 状态返回) |
| error.message | string | 失败原因描述 |
| error.code | string | 错误码,如 upstream_error |
响应示例
任务处理中
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "nano_banana_2",
"status": "in_progress",
"progress": 10,
"created_at": 1709876543
}提交成功(排队中)
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "nano_banana_2",
"status": "queued",
"progress": 0,
"created_at": 1709876543
}任务完成
{
"id": "task_xxxxxxxxxxxxx",
"object": "video",
"model": "nano_banana_2",
"status": "completed",
"progress": 100,
"created_at": 1709876543,
"completed_at": 1709876600,
"url": "https://example.com/images/xxx.jpg",
"image_url": "https://example.com/images/xxx.jpg"
}任务失败
{
"id": "task_xxxx",
"object": "video",
"model": "nano_banana_2",
"status": "failed",
"created_at": 1718123456,
"completed_at": 1718123456,
"progress": 100,
"error": {
"message": "上游任务失败原因",
"code": "upstream_error"
}
}注意事项
/v1/videos 接口,与视频生成共用;通过 model 参数区分(nano_banana 或 nano-banana 开头为图片生成)。aspect_ratio、image_size、images 均为顶层字段,直接放在请求体根对象中。data:image/jpeg;base64,)images 或传空数组 = 文生图images 含图片(URL 或 Base64)= 图生图GET /v1/videos/{task_id}。queued / in_progress 继续等;completed 读取顶层 url 或 image_url;failed 读 error.message。gemini-nano-banana-2.1 使用 image_size 控制分辨率,支持 1K、2K、4K。nano-banana-2.1 固定为 1K,nano-banana-2.1-2K、nano-banana-2.1-4K 以及 Pro 版(如 nano_banana_pro-2K)由 model 名称决定分辨率,无需额外传尺寸参数。图生图表单上传
图生图支持 JSON 和表单。JSON 使用 images 数组;表单使用 input_reference,上传多张图片时重复提交同名字段。
图生图(表单格式 — 本地文件)
curl --request POST 'https://zexapi.com/v1/videos' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--form-string 'model=nano_banana_2' \
--form-string 'prompt=将这张图片转换成油画风格' \
--form-string 'aspect_ratio=16:9' \
--form 'input_reference=@/path/to/reference.png'让你的 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,未明确的接口能力需要向服务提供方确认。
资料范围:当前页面可见文档。不会附带你在调试台填写的密钥或上传素材。普通开发者也可以直接使用完整接口文档。