Nano Banana 2 API 接入文档

使用 VezAPI 密钥接入 Nano Banana 2。下列操作共用同一个账号余额和鉴权方式。

服务地址： https://api.vezapi.com
请求头使用 Authorization: Bearer YOUR_VEZAPI_KEY。每次提交使用唯一的 Idempotency-Key，查询同一笔提交时才复用。

使用 nano-banana-2 生成内容

POST/api/v1/jobs/createTask

模型标识： nano-banana-2

参数	类型	说明与限制
`model` 必填	`string`	用于生成任务的模型名称。必填字段。 - 该端点必须使用 `nano-banana-2` 模型可选值：`"nano-banana-2"` 默认：`"nano-banana-2"`
`callBackUrl` 可选	`string`	接收生成任务完成通知的回调 URL。可选配置，建议在生产环境中使用。 - 任务生成完成后，系统会向该 URL POST 任务状态与结果 - 回调内容包含生成的资源 URL 与任务相关信息 - 您的回调端点需要支持接收带 JSON 负载的 POST 请求 - 也可以选择调用任务详情端点，主动轮询任务状态 - 为确保回调安全性，请参阅 [Webhook 校验指南](/cn/common-api/webhook-verification) 了解签名验证实现方法
`input` 必填	`object`	生成任务的输入参数
`input.aspect_ratio` 可选	`string`	生成图像的宽高比可选值：`"1:1", "2:3", "3:2", "1:4", "4:1", "3:4", "4:3", "4:5", "5:4", "1:8", "8:1", "9:16", "16:9", "21:9", "auto"` 默认：`"auto"`
`input.image_input` 可选	`array`	用于图像变换或作为参考的输入图像（最多支持 10 张图片）（为上传后的文件 URL，非文件内容；支持的类型：image/jpeg、image/png、image/webp；最大文件大小：30.0MB） `maxItems: 10`
`input.output_format` 可选	`string`	生成图像的输出格式可选值：`"jpg", "png"` 默认：`"jpg"`
`input.prompt` 必填	`string`	用于描述待生成图像的文本提示词（最大长度：20000 字符） `maxLength: 20000`
`input.resolution` 可选	`string`	生成图像的分辨率可选值：`"1K", "2K", "4K"` 默认：`"1K"`

请求示例

curl -X POST 'https://api.vezapi.com/api/v1/jobs/createTask' \
  -H 'Authorization: Bearer YOUR_VEZAPI_KEY' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "nano-banana-2",
  "input": {
    "prompt": "Comic poster: cool banana hero in shades leaps from sci-fi pad. Six panels: 1) 4K mountain landscape, 2) banana holds page of long multilingual text with auto translation, 3) Gemini 3 hologram for search/knowledge/reasoning, 4) camera UI sliders for angle focus color, 5) frame trio 1:1-9:16, 6) consistent banana poses. Footer shows Google icons. Tagline: Nano Banana Pro now on Kie AI.",
    "aspect_ratio": "1:1",
    "resolution": "1K"
  }
}'

返回值与错误

HTTP 200

响应字段与业务状态码。

参数	类型	说明与限制
`code` 可选	`integer`	请求的业务状态码。即使请求失败，HTTP 状态也可能是 200，因此必须检查此字段：200 表示成功，其他值表示失败，原因见 msg。常见值：401 密钥无效或缺失；402 积分不足；429 频率超限；422 或 500 请求无法处理，请阅读 msg 并检查参数。提交结果不明时先查询原任务，不要自动新建任务。可选值：`200, 401, 402, 404, 422, 429, 433, 455, 500, 501, 505`
`msg` 可选	`string`	响应消息；失败时说明错误原因。
`data` 必填	`object`
`data.taskId` 必填	`string`	使用任务 ID 调用任务详情接口，查询任务状态与结果。

HTTP 500

响应字段与业务状态码。

参数	类型	说明与限制
`code` 必填	`integer`	业务状态码：200 请求成功；401 鉴权凭据缺失或无效；402 积分不足；404 资源或接口不存在；408 超过 10 分钟未返回结果；422 参数校验失败；429 请求频率超限；455 系统维护；500 处理请求时发生内部错误；501 内容生成失败；505 功能当前关闭。
`msg` 必填	`string`	响应消息；失败时说明错误原因。
`data` 必填	`object`

任务状态与回调

异步任务请保存返回的 taskId。调用 GET /api/v1/jobs/recordInfo?taskId=... 查询，或在创建时设置 callBackUrl。只有任务所属账号可以查询任务或基于任务创建派生资源。

超时可能表示请求已经受理。请在控制台查看原请求，不要自动新建任务。回调可能重试并重复到达，请使用 X-VezAPI-Event-Id 去重。

文件、日志与计费

生成媒体通常随上游保留 14 天，上传文件在 24 小时后失效。请在过期前保存所需文件。VezAPI 仅流式转发已登记资源，不提供永久作品库。请求日志保留两个自然月。

调用前预留积分，最终按实际优惠扣分 1:1 结算。用量不明时暂停新付费请求。若保护其他任务预留后余额不足以结算，会保留待结算记录，补足余额后再扣费；模型用量不会将钱包扣成负数。按时长计价的输入文件由服务端读取时长，读取失败时不提交模型任务。