mingyan
Nano Banana - 创建任务
创建图片生成任务，支持多种模型和分辨率选项
创建图片生成任务
使用 Nano Banana API 创建高质量的 AI 图片生成任务，支持多种模型和分辨率选项。
认证
获取 Key所有请求都需要在请求头中包含 Bearer token：
cURL
Authorization: Bearer {{key}}
基础 URL
https://zcbservice.aizfw.cn/kyyReactApiServerbaseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址，请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。请求参数
modelstring必填模型名称，可选值：
nano-banananano-banana-pronano-banana-pro-stablenano-banana-2-stablenano-banana-2
promptstring必填图片生成提示词
示例：
"一只可爱的橙色猫咪坐在窗台上看着外面的风景"resolutionstringnano-banana、nano-banana-2、nano-banana-2-stable 按受限能力说明，建议按 1K 使用；1k- 1K 分辨率2k- 2K 分辨率4k- 4K 分辨率
sizestring宽高比设置
可选值：
1:1- 正方形16:9- 横屏宽屏9:16- 竖屏4:3- 标准横屏3:4- 标准竖屏3:2- 经典横屏2:3- 经典竖屏5:4- 略宽横屏4:5- 略高竖屏21:9- 超宽屏
image_urlsarray参考图片URL数组，用于指导图片生成风格，最多 6 张
响应参数
idstring图片生成任务的唯一标识符，用于后续查询任务状态
objectstring对象类型，固定为
nanobananacreatedinteger任务创建时间戳
modelstring使用的模型名称
statusstring任务状态：
queued- 排队中processing- 处理中
errorstring错误信息，当 status 为
failed 时返回模型特性
nano-banana-fast
基础模型，快速生成，适合一般用途
nano-banana-2
增强模型，支持分辨率设置，质量更高
nano-banana-pro
专业版模型，最高质量，支持 4K 分辨率
注意事项
重要提示：
- 图片生成为异步处理，需要通过返回的
id查询任务状态和结果 resolution参数仅在使用nano-banana-2或nano-banana-pro模型时有效- 建议轮询间隔为 2-5 秒，避免频繁请求
最佳实践：
- 使用
application/json格式发送请求 - 提示词应该清晰描述所需的图片内容和风格
- 参考图片可以帮助指导生成风格，但不是必需的；最多支持 6 张
- 选择合适的宽高比以匹配你的使用场景