NanoBanana Pro 2K/4K 图像生成

model = nanobanana-pro-2k-4k·¥0.12/张

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

POST /api/v1/images/generations

模型页试一试 →

标准渠道

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

模型 ID

请求体 model 必须为 nanobanana-pro-2k-4k。

简介

Nano Banana 2 旗舰画质（2K / 4K），电影级光影与商业级设计。

Authorizations

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

Authorization: Bearer sk-你的API_Key

Base URL：https://xiaoguai123.xyz

Body

模型名称

固定填写 nanobanana-pro-2k-4k

图像生成的文本描述

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

分辨率档位

影响清晰度与可能的上游计费档位
以 schema 枚举为准
可选：2k / 4k
默认："2k"

resolution	说明
2k	分辨率档位
4k	分辨率档位

使用场景示例

文生图（最简）

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

带默认参数的完整示例

{
  "model": "nanobanana-pro-2k-4k",
  "prompt": "一只橘猫坐在窗台上看夕阳，水彩画风格",
  "resolution": "2k",
  "aspect_ratio": "16:9"
}

图生图 / 编辑

{
  "model": "nanobanana-pro-2k-4k",
  "prompt": "把这张照片变成插画风格",
  "image_urls": [
    "https://example.com/ref.jpg"
  ]
}

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": "nanobanana-pro-2k-4k", "prompt": "霓虹灯下的一只白猫，雨夜街道，电影感", "resolution": "2k" }'

RESPONSE

成功提交

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