Nano Banana Pro（官）图像生成

model = nano-banana-pro·¥0.15/张

异步处理模式：提交后立即返回 task_id，再轮询任务接口
统一生图接口 POST /api/v1/images/generations
异步任务接口：POST /api/v1/images/generations + GET /api/v1/tasks/{task_id}
通过 size 支持 15 种尺寸/比例
通过 resolution 控制：2K / 4K
参考图最多 14 张（URL / base64）
渠道：标准渠道 · 售价 ¥0.15/张 · 失败自动退款

POST /api/v1/images/generations

模型页试一试 →

标准渠道

本模型为标准（经济）路由。同族若存在「官方渠道」条目，可在左侧目录展开切换。

模型 ID

请求体 model 必须为 nano-banana-pro。

简介

Nano Banana Pro 高质量图像生成，支持 2K / 4K 与最多 14 张参考图。

同族渠道

同一模型族下的官方 / 标准渠道，参数与单价可能不同，请按业务选择。

POST Nano Banana Pro 图像生成[标准渠道]

Authorizations

需要 Bearer Token。在 API Key 管理创建后，请求头加入：

Authorization: Bearer sk-你的API_Key

Base URL：https://xiaoguai123.xyz

Body

模型名称

固定填写 nano-banana-pro

图像生成的文本描述

支持中英文，建议详细描述
可能触发内容安全策略，违规会直接报错

尺寸 / 画面比例

按枚举或像素串传入
未知值会被拒绝
可选：auto / 1:1 / 3:2 / 2:3 / 4:3 / 3:4 / 5:4 / 4:5 / 16:9 / 9:16 / 21:9 / 1:4 / 4:1 / 1:8 / 8:1
默认："1:1"

size	类型
auto	自动
1:1	正方
3:2	横图
2:3	竖图
4:3	横图
3:4	竖图
5:4	横图
4:5	竖图
16:9	横图
9:16	竖图
21:9	横图
1:4	枚举
4:1	枚举
1:8	枚举
8:1	枚举

使用场景示例

文生图（最简）

{
  "model": "nano-banana-pro",
  "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格"
}

带默认参数的完整示例

{
  "model": "nano-banana-pro",
  "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格",
  "size": "1:1",
  "resolution": "2K",
  "n": 1,
  "optimizeChineseText": false
}

图生图 / 编辑

{
  "model": "nano-banana-pro",
  "prompt": "把这张照片变成插画风格",
  "image_urls": [
    "https://example.com/ref.jpg"
  ],
  "size": "1:1"
}

Response

提交成功时返回任务数组：

status：如 submitted（已提交）
task_id：任务唯一标识，用于后续查询

查询任务结果

GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}
Authorization: Bearer sk-你的API_Key

• 提交（OpenAI 兼容）：POST https://xiaoguai123.xyz/api/v1/images/generations

• 查询（OpenAI 兼容）：GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}

• 提交（原生）：POST https://xiaoguai123.xyz/api/v1/images/generations

• 查询（原生）：GET https://xiaoguai123.xyz/api/v1/tasks/{task_id}

• status=completed 时读取 result.images / result.videos；failed 已自动退款

详见任务查询接口。

状态	含义
pending / submitted	已提交或排队
processing	上游处理中
completed	成功，result 可用
failed	失败，已自动退款

REQUEST

curl -X POST https://xiaoguai123.xyz/api/v1/images/generations \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{ "model": "nano-banana-pro", "prompt": "霓虹灯下的一只白猫，雨夜街道，电影感", "size": "1:1", "resolution": "2K" }'

RESPONSE

成功提交

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "xg_01hxyz..."
    }
  ]
}