@henjicc/ai-sdk 0.2.8

package/docs/model-adaptation/Nano-Banana-2/Nano-Banana-2_APIMart.md

@@ -0,0 +1,89 @@
+# Nano Banana 2 · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 模态 | 图片 |
+| 供应商 | APIMart（聚合平台） |
+| 平台模型 ID | 标准版 `gemini-3.1-flash-image-preview`（别名 `nano-banana-2-ext`）<br>官方版 `gemini-3.1-flash-image-preview-official`（别名 `nano-banana-2`） |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> **Nano Banana 2 Lite 已拆分为独立文档**：[Nano-Banana-2-Lite_APIMart.md](../Nano-Banana-2-Lite/Nano-Banana-2-Lite_APIMart.md)。它在代码里对应独立的 `canonicalModelId: nano-banana-2-lite`（[catalog/apimart/nano-banana-2-lite.model.ts](../../../src/catalog/apimart/nano-banana-2-lite.model.ts)），是独立产品模型，不是本模型的渠道或分辨率选项——本文件只覆盖主模型的标准版 / 官方版两条渠道。
+
+---
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.apimart.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /v1/images/generations` → `{ code, data: [{ status: "submitted", task_id }] }`
+- **查询**：`GET /v1/tasks/{task_id}`，读 `result.images`
+- **回调**（仅 Lite 文档明确提供）：`webhook` 参数传 base 地址，平台回调 `webhook + /callback`（不转发上游），仍建议保留轮询兜底
+
+---
+
+## 2. 主模型 `gemini-3.1-flash-image-preview` / `-official`
+
+### 2.1 能力
+
+文生图 / 图生图；最多 **14 张**参考图；最高 **4K**；支持**极端宽高比**（1:4、4:1、1:8、8:1）；集成 **Google Search 搜索增强**。
+
+### 2.2 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必填 | `gemini-3.1-flash-image-preview` | 标准版 `gemini-3.1-flash-image-preview`（别名 `nano-banana-2-ext`）；官方版 `gemini-3.1-flash-image-preview-official`（别名 `nano-banana-2`） |
+| `prompt` | string | 必填 | — | 图像生成描述 |
+| `size` | string | 可选 | — | `auto`、`1:1`、`3:2`、`2:3`、`4:3`、`3:4`、`16:9`、`9:16`、`5:4`、`4:5`、`21:9`、`1:4`、`4:1`、`1:8`、`8:1`。**`auto` 时文生图默认 `1:1` 或 `16:9`；图生图按上游返回比例为准——建议始终显式指定** |
+| `resolution` | string | 可选 | `1K` | `0.5K`（约 512px）/ `1K`（约 1024px）/ `2K`（约 2048px）/ `4K`（约 4096px）。**不同分辨率计费不同** |
+| `n` | integer | 可选 | `1` | **取值只能是 1**。必须传纯数字 |
+| `image_urls` | array | 可选 | — | 参考图。**最多 14 张**（建议最多 10 张物体参考 + 4 张角色参考）；单张 ≤ 10 MB；格式 jpeg/png/webp；支持公网 URL 或完整 Data URI（前缀不能省） |
+| `google_search` | boolean | 可选 | `false` | Google **文字**搜索增强，适合需要真实信息的场景 |
+| `google_image_search` | boolean | 可选 | `false` | Google **图片**搜索增强。**必须配合 `google_search: true`** |
+| `official_fallback` | boolean | 可选 | `false` | 官方渠道兜底。**使用 `-official` 模型时不能带此参数** |
+| `nsfw_check` | boolean | 可选 | `false` | `true` 时用 `omni-moderation-latest` 预审 |
+
+### 2.3 价格
+
+来源：[APIMart 定价中心](https://apimart.ai/zh/pricing)与[Nano Banana 3 模型页](https://apimart.ai/zh/model/nano-banana-3-api)（2026-08-28，1 Credit ≈ $0.1）。
+
+**NANO-BANANA-2-EXT**（按张，5 档）
+
+| 规格 | 我们的价格 | 官方价 | 节省 |
+|---|---|---|---|
+| 默认 / 0.5K / 1K | 0.15 Credits/张 ≈ **$0.015/张** | $0.01875 | 20% |
+| 2K | 0.2 Credits/张 ≈ **$0.02/张** | $0.025 | 20% |
+| 4K | 0.25 Credits/张 ≈ **$0.025/张** | $0.03125 | 20% |
+
+**NANO-BANANA-2**（官方渠道，按 token）
+
+| 计费项 | 我们的价格 | 官方价 |
+|---|---|---|
+| 文本输入 | 4 Credits/M ≈ $0.4/M | $0.5/M |
+| 图片输入 | 4 Credits/M ≈ $0.4/M | $0.5/M |
+| 文本输出 | 24 Credits/M ≈ $2.4/M | $3/M |
+| 图片输出 | 480 Credits/M ≈ **$48/M** | $60/M |
+
+SDK 对官方渠道采用模型页给出的当前单张估算：0.5K/1K **$0.0536**、2K **$0.0808**、4K **$0.1208**；实际账单仍按 token 结算。
+
+---
+
+## 3. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。APIMart 这两个渠道都没有这两个字段。
+- 主模型 `n` 只能是 1；`n` 必须是数字类型。
+- `size: auto` 在文生图与图生图下行为不同，建议永远显式下发比例。
+- `google_image_search` 依赖 `google_search`，两者要做联动。
+- SDK 用首位 `apimartNanoBanana2Channel` 参数表达渠道，默认 `standard` 保持 0.1.5 的 EXT 请求；`official` 只切换为精确官方模型 ID，不发送 `official_fallback`。
+- Lite 版本不要并入本模型：分辨率档位、比例集合、`n` 上限、搜索增强、计费方式都不同，是独立产品，见 [Nano-Banana-2-Lite_APIMart.md](../Nano-Banana-2-Lite/Nano-Banana-2-Lite_APIMart.md)。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Nano banana2 图像生成（主模型） | https://docs.apimart.ai/cn/api-reference/images/gemini-3.1-flash/generation | 否 |
+| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
+| 定价中心（搜 NANO-BANANA-2-EXT / NANO-BANANA-2） | https://apimart.ai/zh/pricing | 否 |
+| API Key 管理 | https://apimart.ai/keys | **是** |

package/docs/model-adaptation/Nano-Banana-2/Nano-Banana-2_Fal.md

@@ -0,0 +1,99 @@
+# Nano Banana 2 · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-26 |
+| 模态 | 图片 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `fal-ai/nano-banana-2`、`fal-ai/nano-banana-2/edit` |
+| 接口形态 | 队列异步（推荐）或同步直连 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> **Fal 没有 Nano Banana 2 Lite。** 探测过 `fal-ai/nano-banana-2/lite`、`fal-ai/nano-banana-2-lite`、`fal-ai/nano-banana-2/lite/edit`、`fal-ai/nano-banana-2/fast` 均返回 404，主端点 `llms.txt` 全文也没有 "lite" 字样（2026-08-26 实测）。Fal 上想要低成本出图目前只能靠本模型的 `resolution: 0.5K` 档位，不是独立产品，因此本项目没有为 Fal 建 `Nano-Banana-2-Lite_Fal.md`。
+
+## 1. 接入协议（Fal 通用）
+
+- **鉴权**：`Authorization: Key $FAL_KEY`
+- **同步**：`POST https://fal.run/<endpoint-id>`；**队列**：`POST https://queue.fal.run/<endpoint-id>`，`GET .../requests/{id}/status`（`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`）、`GET .../requests/{id}`
+- **权威 schema**：`https://fal.ai/models/<endpoint-id>/llms.txt`
+
+## 2. 能力清单
+
+| 能力 | endpoint id |
+|---|---|
+| 文生图 | `fal-ai/nano-banana-2` |
+| 图像编辑（并可用**视频 / 音频 / PDF 作为上下文**） | `fal-ai/nano-banana-2/edit` |
+
+> Fal 的 `edit` 端点是本模型所有供应商里能力最强的：除参考图外还接受 `video_url` / `audio_url` / `pdf_url` 作为输入上下文。
+
+## 3. 请求参数
+
+### 3.1 两个端点共有
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `prompt` | string | 必填 | — | 生成 / 编辑描述 |
+| `num_images` | integer | 可选 | `1` | 1–4 |
+| `seed` | integer | 可选 | 随机 | **本项目规则：绝对不显示**，不下发 |
+| `aspect_ratio` | string | 可选 | `auto` | `auto`、`21:9`、`16:9`、`3:2`、`4:3`、`5:4`、`1:1`、`4:5`、`3:4`、`2:3`、`9:16`、`4:1`、`1:4`、`8:1`、`1:8`（含极端比例） |
+| `output_format` | string | 可选 | `png` | `jpeg` / `png` / `webp` |
+| `safety_tolerance` | string | 可选 | `"4"` | `"1"`（最严）~ `"6"`（最松） |
+| `sync_mode` | boolean | 可选 | `false` | `true` 时以 data URI 返回且不入请求历史 |
+| `system_prompt` | string | 可选 | `""` | 系统指令，用于统一人设与输出风格；作为 system instruction 下发给 Gemini |
+| `resolution` | string | 可选 | `1K` | `0.5K` / `1K` / `2K` / `4K` |
+| `limit_generations` | boolean | 可选 | **`true`** | 实验性参数：限制每轮提示只出 1 张，**忽略 prompt 中关于生成数量的指令与模型的中间图**。文档提示这可能影响生成质量 |
+| `enable_web_search` | boolean | 可选 | `false` | 联网搜索最新信息辅助生成 |
+| `thinking_level` | string | 可选 | 不启用 | `minimal` / `high`。设置后启用模型思考并在生成中包含思考过程；**省略即关闭** |
+
+### 3.2 仅 `edit` 有
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `image_urls` | string[] | **可选** | 图生图 / 图像编辑的输入图。当 `video_url` / `audio_url` / `pdf_url` 至少提供一个时可省略 |
+| `video_url` | string | 可选 | 视频作为输入上下文。接受 http(s)/data URL（下载后内联，**≤ 15 MB**）或 YouTube URL（直接透传给模型，不下载） |
+| `audio_url` | string | 可选 | 音频作为输入上下文。http(s)/data URL，下载内联，**≤ 15 MB** |
+| `pdf_url` | string | 可选 | PDF 作为输入上下文。http(s)/data URL，下载内联，**≤ 15 MB** |
+
+## 4. 响应结构
+
+```json
+{ "images": [ { "url": "https://...", "content_type": "image/png", "width": 1024, "height": 1024 } ],
+  "description": "（模型对生成图像的描述）" }
+```
+
+`images` 与 `description` 都是必返回字段。
+
+## 5. 价格
+
+来源：两个端点的 `llms.txt`（2026-08-22 读取）。Fal 标注 **Pricing is subject to change**。
+
+| 项 | 价格 |
+|---|---|
+| 基础（1K） | **$0.08 / 张**（$1.00 可跑 12 次） |
+| 0.5K（512px） | 标准价 × **0.75** |
+| 2K | 标准价 × **1.5** |
+| 4K | 标准价 × **2** |
+| `enable_web_search` | 额外 **+$0.015** |
+| `thinking_level: high` | 额外 **+$0.002** |
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。Fal 本端点**有 `seed`**（不下发），无负面提示词字段。
+- `output_format`、`sync_mode` 不展示、不请求。
+- `limit_generations` 默认 `true`，会**忽略 prompt 中的数量指令并丢弃中间图**，且文档承认可能影响质量——若产品发现出图与提示词不符，先查这个默认值。
+- `edit` 的 `image_urls` 是可选的，但必须至少提供 `image_urls` / `video_url` / `audio_url` / `pdf_url` 之一，参数校验要覆盖。
+- 视频/音频/PDF 上下文是 Fal 独有能力（其他供应商都没有），若要用需注意 15 MB 上限。
+- 搜索增强与 thinking 都会**额外加价**，开关要在成本估算里体现。
+- Fal 是唯一提供 `safety_tolerance` 分级的 Nano Banana 2 供应商。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文生图模型页 | https://fal.ai/models/fal-ai/nano-banana-2 | 否 |
+| 文生图 schema + 价格 | https://fal.ai/models/fal-ai/nano-banana-2/llms.txt | 否 |
+| 编辑模型页 | https://fal.ai/models/fal-ai/nano-banana-2/edit | 否 |
+| 编辑 schema + 价格 | https://fal.ai/models/fal-ai/nano-banana-2/edit/llms.txt | 否 |
+| 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
+| API Key 创建 | https://fal.ai/dashboard/keys | **是** |

package/docs/model-adaptation/Nano-Banana-2/Nano-Banana-2_Grsai.md

@@ -0,0 +1,82 @@
+# Nano Banana 2 · Grsai
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-26 |
+| 模态 | 图片 |
+| 供应商 | Grsai（聚合中转，详见 [Grsai 基础文档](../供应商/Grsai.md)） |
+| 平台模型 ID（渠道） | `nano-banana-2`、`nano-banana-2-cl`、`nano-banana-2-2k-cl`、`nano-banana-2-4k-cl` |
+| 接口形态 | 提交 `POST /v1/api/generate` + 轮询 `GET /v1/api/result`（新版统一接口，`replyType` 三选一） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录（dashboard「模型列表」页） |
+| 项目当前状态 | 已接入，[catalog/grsai/nano-banana-2.model.ts](../../../src/catalog/grsai/nano-banana-2.model.ts)，`canonicalModelId: nano-banana-2` |
+
+> Grsai 上 Nano Banana 2 家族在 dashboard 里共有 5 个平台模型名，但其中 `nano-banana-2-lite` 是**独立产品「Nano Banana 2 Lite」的渠道**，已拆到 [Nano-Banana-2-Lite_Grsai.md](../Nano-Banana-2-Lite/Nano-Banana-2-Lite_Grsai.md)（与 APIMart / KIE 两家供应商把 Lite 当独立模型的处理方式保持一致）；另有一个价格/规格与它几乎一样的 `nano-banana-fast`，属于已排除的初代「香蕉」命名，不适配、不出现在任何渠道枚举里，见 [Grsai 基础文档 §7](../供应商/Grsai.md)。本文件只覆盖 Nano Banana 2 主模型的 **4 个渠道**：官方渠道级价差可达约 **10.8 倍**（`nano-banana-2` ¥0.06 起 vs `nano-banana-2-4k-cl` 最高 ¥1.3），越贵的 `cl` 系渠道换来更高分辨率与官方公告里暗示的更好稳定性；`cl` 渠道历史上出现过两次专门针对它的调价（见第 4 节），侧面印证「cl 渠道更便宜但更容易被上游限流/降级」的说法。适配时建议做成模型内的「渠道」参数，而不是拆成 4 个模型卡片。
+
+## 1. 请求参数（新版统一接口）
+
+`POST /v1/api/generate`：
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `model` | string | 必填 | 四个渠道枚举之一，见下表 |
+| `prompt` | string | 必填 | 提示词 |
+| `images` | array\<string\> | 可选 | 参考图，base64 或 URL 混填，无需单独上传 |
+| `aspectRatio` | string | 可选 | 见 1.1 |
+| `imageSize` | string | 可选 | `1K` / `2K` / `4K`，具体渠道支持哪些档见第 2 节表格 |
+| `replyType` | string | 可选 | `json` / `stream` / `async` |
+
+### 1.1 `aspectRatio` 取值
+
+通用 11 档：`auto`、`1:1`、`16:9`、`9:16`、`4:3`、`3:4`、`3:2`、`2:3`、`5:4`、`4:5`、`21:9`
+
+**Nano Banana 2 系列额外支持极端比例**：`1:4`、`4:1`、`1:8`、`8:1`（API 文档原文特别标注这四档是「nano-banana-2 系列额外支持」，未注明是否四个渠道全部适用，接入前需逐渠道实测）。
+
+## 2. 四个渠道对照
+
+来源：[dashboard 模型列表](https://grsai.com/zh/dashboard/models)（2026-08-26 实测，未登录可见）。价格区间由「积分消耗 × 积分单价区间」得出，下限对应 ¥999 最高档充值套餐（约 5 折），上限对应无优惠单价，详见 [Grsai 基础文档 §5.1](../供应商/Grsai.md)。
+
+| 渠道 | 积分消耗 | 价格区间 | 支持分辨率 | 相对基准倍率 |
+|---|---|---|---|---|
+| `nano-banana-2` | 1200/次 | ¥0.06~¥0.12/次 | 1K / 2K / 4K | 1×（基准） |
+| `nano-banana-2-cl` | 6000/次 | ¥0.3~¥0.6/次 | 1K | 5× |
+| `nano-banana-2-2k-cl` | 9000/次 | ¥0.45~¥0.9/次 | 2K | 7.5× |
+| `nano-banana-2-4k-cl` | 13000/次 | ¥0.65~¥1.3/次 | 4K | 10.8× |
+
+更便宜的 Lite 定位渠道 `nano-banana-2-lite` 属于独立产品「Nano Banana 2 Lite」，见 [Nano-Banana-2-Lite_Grsai.md](../Nano-Banana-2-Lite/Nano-Banana-2-Lite_Grsai.md)（`nano-banana-fast` 不适配，见该文档第 1 节）。
+
+## 3. 响应
+
+结构、状态枚举、结果链接有效期等公共部分见 [Grsai 基础文档](../供应商/Grsai.md) 第 3、8 节，四个渠道共用同一套响应格式，不在本文件重复。
+
+## 4. 价格变动历史（公告原文摘录，供判断渠道稳定性参考）
+
+- 2026-04-14：因 Gemini 官方缩减算力，`cl` 与 `vip` 系渠道被迫更换后端线路，成本上升，两类渠道当日集体涨价
+- 2026-06-19：香蕉系列 2K/4K 分辨率一度因谷歌官方 BUG 无法出图，1K 分辨率不受影响，同日恢复
+- 2026-06-24：「cl 渠道模型」分辨率与价格调整——`nano-banana-pro-cl` 支持分辨率范围收窄（详情见 [Nano Banana Pro 文档](../Nano-Banana-Pro/Nano-Banana-Pro_Grsai.md)）
+- 2026-06-28：「cl 渠道模型」**二次调价**，公告原文「近期风控严峻导致成本骤升……目前仍处于亏损状态」
+- 2026-07-01：谷歌官方下架 `gemini-2.5-flash-image`（香蕉 1），Grsai 下架旧版 `nano-banana`，`nano-banana-fast` 切换底层模型（`nano-banana`、`nano-banana-fast` 均属初代「香蕉」命名，本项目已明确排除，不适配，见 [Grsai 基础文档 §7](../供应商/Grsai.md)）
+- 2026-07-10 / 2026-08-11：`nano-banana-2` 与 `nano-banana-pro` 因谷歌官方策略/算法变动，各发生过一次数小时到近一天的整体维护/异常，与渠道无关，是模型家族级别的不稳定
+
+`cl` 系渠道在半年内至少经历两次专门针对它的调价，且调价原因都指向「上游限流/成本上升」，与用户描述的「渠道便宜但不稳定」一致；主渠道（`nano-banana-2`）本身也发生过因谷歌官方变动导致的全家族级维护，说明不稳定风险不完全集中在便宜渠道上。
+
+## 5. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。四个渠道文档都没有这两个字段。
+- 四个渠道共享同一套请求/响应结构，只有 `model` 枚举值、可选分辨率档位、价格不同。渠道参数按项目约定声明 `role: 'channel'` + `sharedFieldText('apiChannel')`（字段名统一显示「渠道」），选项文案则由模型自定义为「标准 / CL·1K / CL·2K / CL·4K」——项目不约束渠道选项文案，`sharedOptionText('regular' | 'official')` 只适用于恰好「第三方 vs 官方」两档的场景。
+- 标准渠道的分辨率（1K/2K/4K）是价格无关的自由选择；`cl` 三档的分辨率是绑死在渠道本身上的独立计价档位，代码直接把「渠道 + 分辨率」压平成 4 个渠道选项，只有选到「标准」时才显示分辨率下拉。
+- `pricing.calculator` 按渠道返回区间上限（无优惠价）：标准 ¥0.12、CL·1K ¥0.6、CL·2K ¥0.9、CL·4K ¥1.3。
+- `nano-banana-2-lite` 属于独立产品「Nano Banana 2 Lite」，不要并入本模型的渠道列表，适配要点见 [Nano-Banana-2-Lite_Grsai.md](../Nano-Banana-2-Lite/Nano-Banana-2-Lite_Grsai.md)。
+- `nano-banana-fast` 已被明确排除、不适配，不要出现在本模型或 Lite 模型的任何渠道枚举里，见 [Grsai 基础文档 §7](../供应商/Grsai.md)。
+- 极端比例（1:4/4:1/1:8/8:1）文档未逐渠道确认是否全部支持，代码目前对四个渠道一视同仁地暴露这些选项，接入前建议用真实任务核实 `cl` 系渠道是否真的接受。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| nano-banana 接口（新版统一生成，含全部渠道枚举与比例说明） | https://qmy27nhsd9.apifox.cn/452392911e0 | 否 |
+| 异步生成结果查询接口 | https://qmy27nhsd9.apifox.cn/452409577e0 | 否 |
+| Nano Banana API 旧版文档 | https://grsai.ai/zh/dashboard/documents/nano-banana | 否 |
+| dashboard 模型列表（当前权威价格） | https://grsai.com/zh/dashboard/models | 否 |
+| dashboard 公告（渠道调价与模型上下架历史） | https://grsai.com/zh/dashboard/announcements | 否 |
+| API Key 管理 | https://grsai.ai/zh/dashboard/api-keys | **是** |

package/docs/model-adaptation/Nano-Banana-2/Nano-Banana-2_KIE.md

@@ -0,0 +1,70 @@
+# Nano Banana 2 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-26 |
+| 模态 | 图片 |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID | `nano-banana-2` |
+| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> **Nano Banana 2 Lite 已拆分为独立文档**：[Nano-Banana-2-Lite_KIE.md](../Nano-Banana-2-Lite/Nano-Banana-2-Lite_KIE.md)。它在代码里对应独立的 `canonicalModelId: nano-banana-2-lite`（[catalog/kie/nano-banana-2-lite.model.ts](../../../src/catalog/kie/nano-banana-2-lite.model.ts)），是独立产品模型——本文件只覆盖主模型 `nano-banana-2`。
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.kie.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /api/v1/jobs/createTask`，体为 `{ model, callBackUrl?, input }`
+- **查询**：`GET /api/v1/jobs/recordInfo?taskId=...`
+- **结果**：`JSON.parse(resultJson)` → `{ resultUrls: [...] }`
+
+## 2. 能力清单
+
+`nano-banana-2`：文生图 + 图生图合一（有无 `image_input` 都走同一个 model）。KIE **没有把文生图/图生图拆成两个 model**，这与它家 Seedream / Qwen 的做法不同。
+
+## 3. 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | 必填 | — | 最多 **20000** 字符 |
+| `input.aspect_ratio` | string | 可选 | `auto` | 15 个取值：`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`（**含极端比例**） |
+| `input.image_input` | array | 可选 | — | 输入图。**最多 14 张**。注意字段名是 **`image_input`**，不是 `image_urls`。传上传后的文件 URL；支持 `image/jpeg`、`image/png`、`image/webp`；**单张 ≤ 30 MB** |
+| `input.output_format` | string | 可选 | **`jpg`** | `jpg` / `png`（注意是 `jpg` 不是 `jpeg`） |
+| `input.resolution` | string | 可选 | `1K` | `1K` / `2K` / `4K`（**没有 0.5K**） |
+
+## 4. 响应结构
+
+`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`。
+
+## 5. 价格
+
+来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `nano banana`；1 Credit = $0.005）。
+
+**Google nano banana 2**
+
+| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
+|---|---|---|---|---|
+| 1K | 8 /张 | **$0.04/张** | $0.08 | 50% |
+| 2K | 12 /张 | **$0.06/张** | $0.12 | 50% |
+| 4K | 18 /张 | **$0.09/张** | $0.16 | 43.8% |
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本接口两个字段都没有。
+- `output_format` 默认不显示、不请求；注意取值是 `jpg`（不是 `jpeg`），且默认 `jpg` 与其他供应商的 `png` 不同。
+- 比例集合含 4 个极端比例（1:4 / 4:1 / 1:8 / 8:1）。
+- 无 `google_search` 类搜索增强参数。
+- `resultJson` 是 JSON 字符串，必须二次 parse。
+- Lite 版本不要并入本模型：图片字段名（`image_urls` vs `image_input`）、数量上限（10 vs 14）都不同，是独立产品，见 [Nano-Banana-2-Lite_KIE.md](../Nano-Banana-2-Lite/Nano-Banana-2-Lite_KIE.md)。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| nano-banana-2 | https://docs.kie.ai/cn/market/google/nanobanana2 | 否 |
+| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| 定价页（搜 `nano banana`） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |

package/docs/model-adaptation/Nano-Banana-2-Lite/Nano-Banana-2-Lite_APIMart.md

@@ -0,0 +1,79 @@
+# Nano Banana 2 Lite · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 模态 | 图片 |
+| 供应商 | APIMart（聚合平台） |
+| 平台模型 ID | `gemini-3.1-flash-lite-image`（官方渠道）/ `gemini-3.1-flash-lite-image-ext`（常规 EXT 渠道） |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+| 项目对照 | [catalog/apimart/nano-banana-2-lite.model.ts](../../../src/catalog/apimart/nano-banana-2-lite.model.ts)，`canonicalModelId: 'nano-banana-2-lite'`，与 [Nano Banana 2](../Nano-Banana-2/Nano-Banana-2_APIMart.md) 是**两个独立的产品模型**，不是同一模型下的渠道/分辨率选项 |
+
+> Nano Banana 2 Lite 是 Gemini 3.1 系列里**最快、最便宜**的图像模型，走 Developer API 的 `interactions` 端点，主打规模化低成本出图。它与 Nano Banana 2 主模型共享同一份 API 文档页（`generation-lite` 是主文档页的姊妹页），但**能力集合、限制、计费方式都不同**，本项目在代码里已经把它拆成独立模型（`canonicalModelId: nano-banana-2-lite`），本文件把它对应拆成独立文档，不再挂在 Nano Banana 2 文件里。
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.apimart.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /v1/images/generations` → `{ code, data: [{ status: "submitted", task_id }] }`
+- **查询**：`GET /v1/tasks/{task_id}`，读 `result.images`
+- **回调**：支持 `webhook` 参数（base 地址，平台回调 `webhook + /callback`），桌面端不用，走轮询
+
+## 2. 与 Nano Banana 2 主模型的能力差异（文档明列）
+
+| 项 | 主模型（Nano Banana 2） | Lite |
+|---|---|---|
+| 分辨率 | 0.5K / 1K / 2K / 4K | **仅 1K**。传 2K/4K/0.5K 会**静默降级为 1K，不报错**，前端不应暴露分辨率选项 |
+| 比例 | 15 个（含 1:4 / 4:1 / 1:8 / 8:1 极端比例） | **11 个**（`auto`、`1:1`、`3:2`、`2:3`、`4:3`、`3:4`、`16:9`、`9:16`、`5:4`、`4:5`、`21:9`），**无极端比例** |
+| `n` | 只能 1 | **1–4**（`n>1` 后端并发多次上游请求，按实际成功张数计费；文档建议前端固定传 1） |
+| `google_search` / `google_image_search` | 支持 | **不支持**。上游未开放 Search 工具（会返回 "Search as tool is not enabled for this model"），平台适配器也不下发。**传了不报错、照常出图，但没有任何搜索增强效果** |
+| `official_fallback` | 支持 | **不支持**，且无 `-official` 变体 |
+| 计费 | 按张固定价 | **按 token** |
+| `mask_url` 局部重绘 | 不支持 | 不支持（Gemini 系列走 aspect ratio + 参考图，不走蒙版） |
+
+## 3. 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必填 | `gemini-3.1-flash-lite-image` | 官方渠道；常规渠道使用 EXT 别名 `gemini-3.1-flash-lite-image-ext` |
+| `prompt` | string | 必填 | — | 图像生成描述 |
+| `size` | string | 可选 | — | 11 个比例（见第 2 节），无极端比例；`auto` 行为与主模型一致，建议始终显式指定 |
+| `n` | integer | 可选 | `1` | 1–4，建议前端固定传 1 |
+| `image_urls` | array | 可选 | — | 参考图，最多 **14 张**；单张 ≤ 10 MB；格式 jpeg/png/webp；支持公网 URL 或完整 Data URI |
+| `nsfw_check` | boolean | 可选 | `false` | `true` 时用 `omni-moderation-latest` 预审 |
+| `webhook` | string | 可选 | — | 回调基址，桌面端不使用 |
+
+## 4. 价格
+
+来源：[APIMart 定价中心](https://apimart.ai/zh/pricing)与[Nano Banana 2 模型页的 Lite 档](https://apimart.ai/zh/model/nano-banana-3-api)（2026-08-28，1 Credit ≈ $0.1）。
+
+| 计费口径 | 我们的价格 | 官方价 | 节省 |
+|---|---|---|---|
+| `NANO-BANANA-2-LITE-EXT`（按张，1K） | 0.125 Credits/张 ≈ **$0.0125/张** | $0.015625 | 20% |
+| `NANO-BANANA-2-LITE`（官方渠道，按 token）文本/图片输入 | 2 Credits/M ≈ $0.2/M | — | — |
+| `NANO-BANANA-2-LITE`（官方渠道，按 token）文本输出 | 12 Credits/M ≈ $1.2/M | — | — |
+| `NANO-BANANA-2-LITE`（官方渠道，按 token）图片输出 | 240 Credits/M ≈ **$24/M** | — | — |
+
+SDK 对官方渠道采用模型页当前估算 **$0.032/张**；实际账单仍按 token 结算。
+
+## 5. 水印
+
+所有 Lite 生成的图片含 Google **SynthID** 隐形水印（上游行为，**无法关闭**）。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。本模型没有这两个字段。
+- **必须与 Nano Banana 2 主模型分开建模**：分辨率档位、比例集合、`n` 上限、搜索增强、计费方式全都不同，这点在代码里已经落实（`nano-banana-2-lite.model.ts` 独立文件、独立 `canonicalModelId`），文档现在也拆开，避免下次调研时把两者当成同一模型的参数分支去理解。
+- 「传高分辨率静默降级」和「传 `google_search` 静默无效」两处是**沉默失败**，UI 上不要暴露这些开关，否则用户会以为生效了。
+- SDK 用首位 `apimartNanoBanana2LiteChannel` 参数表达双渠道，默认 `standard` 保持 0.1.5 的 EXT 请求；`official` 精确映射到无 `-official` 后缀的 `gemini-3.1-flash-lite-image`，估价同步切换为 token 模型页单张估算。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Nano Banana Lite 图像生成 | https://docs.apimart.ai/cn/api-reference/images/gemini-3.1-flash/generation-lite | 否 |
+| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
+| 定价中心（搜 NANO-BANANA-2-LITE-EXT / NANO-BANANA-2-LITE） | https://apimart.ai/zh/pricing | 否 |
+| API Key 管理 | https://apimart.ai/keys | **是** |

package/docs/model-adaptation/Nano-Banana-2-Lite/Nano-Banana-2-Lite_Grsai.md

@@ -0,0 +1,65 @@
+# Nano Banana 2 Lite · Grsai
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-26 |
+| 模态 | 图片 |
+| 供应商 | Grsai（聚合中转，详见 [Grsai 基础文档](../供应商/Grsai.md)） |
+| 平台模型 ID（渠道） | `nano-banana-2-lite`（只有这一个渠道，见下方排除说明） |
+| 接口形态 | 提交 `POST /v1/api/generate` + 轮询 `GET /v1/api/result`（新版统一接口，`replyType` 三选一） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录（dashboard「模型列表」页） |
+| 项目当前状态 | 已接入，[catalog/grsai/nano-banana-2-lite.model.ts](../../../src/catalog/grsai/nano-banana-2-lite.model.ts)，`canonicalModelId: nano-banana-2-lite` |
+
+> 本项目把 Nano Banana 2 Lite 当作独立产品模型（`canonicalModelId: nano-banana-2-lite`），与 [Nano Banana 2](../Nano-Banana-2/Nano-Banana-2_Grsai.md) 主模型分开建档，这个 Grsai 平台模型名原本记录在 Nano Banana 2 的 Grsai 文档里，现拆分到本文件，与 APIMart / KIE 的文档结构保持一致。
+
+## 1. `nano-banana-fast` 已被明确排除，不要与本模型混淆
+
+dashboard「模型列表」页还有一个 `nano-banana-fast`，积分消耗（440/次）、价格区间（¥0.022~¥0.044/次）、能力标签都与 `nano-banana-2-lite` **完全相同**，非常容易被当成同一个模型的两个入口收进 schema。
+
+**它不是 Nano Banana 2 Lite，本项目不适配它**：`nano-banana-fast` 属于最早期「香蕉 1」世代的命名——2026-07-01 公告显示，谷歌官方下架 `gemini-2.5-flash-image`（香蕉 1）后，Grsai 下架了 `nano-banana`，`nano-banana-fast` 这个名字保留了下来并「切换底层模型」，此后实际跑在新的 Gemini 3.1 Lite 底层上，只是名字还留着旧世代的痕迹。本项目适配范围只到 Nano Banana 第 2 代与 Nano Banana Pro，不包含初代「香蕉」体系的任何遗留命名。完整排除记录见 [Grsai 基础文档 §7](../供应商/Grsai.md)。
+
+后续调研如果发现价格/规格与 `nano-banana-2-lite` 一样接近的新名字，先去 Grsai 基础文档 §7 确认是否已经记录过，不要重复讨论是否该收进来。
+
+## 2. 请求参数（新版统一接口）
+
+`POST /v1/api/generate`：
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `model` | string | 必填 | `nano-banana-2-lite` |
+| `prompt` | string | 必填 | 提示词 |
+| `images` | array\<string\> | 可选 | 参考图，base64 或 URL 混填，无需单独上传 |
+| `aspectRatio` | string | 可选 | 通用 11 档（`auto`/`1:1`/`16:9`/`9:16`/`4:3`/`3:4`/`3:2`/`2:3`/`5:4`/`4:5`/`21:9`）；极端比例（`1:4`/`4:1`/`1:8`/`8:1`）文档标注为「nano-banana-2 系列额外支持」，Lite 是否包含在内未逐渠道验证 |
+| `replyType` | string | 可选 | `json` / `stream` / `async` |
+
+代码没有为本模型注册 `imageSize` 参数、也不发送该字段——dashboard 页面未给这个渠道标注分辨率档位标签，类比 APIMart/KIE 的 Lite 均固定 1K，选择不暴露而不是猜一个可能报错的值。若后续证实 Grsai 这一档确实支持可选分辨率，再补参数。
+
+## 3. 价格
+
+来源：[dashboard 模型列表](https://grsai.com/zh/dashboard/models)（2026-08-26 实测，未登录可见）。价格区间由「积分消耗 × 积分单价区间」得出，详见 [Grsai 基础文档 §5.1](../供应商/Grsai.md)。
+
+| 渠道 | 积分消耗 | 价格区间 | 支持分辨率 |
+|---|---|---|---|
+| `nano-banana-2-lite` | 440/次 | ¥0.022~¥0.044/次 | 未标注（推断仅默认档） |
+
+作为对照，同为 Lite 定位的其他供应商价格：APIMart EXT 渠道 **$0.0125/张**（约¥0.09，2026-08-22 汇率粗算）、KIE **$0.02/张**（约¥0.14）。Grsai 的 ¥0.022~¥0.044 区间在同类里明显更低，与「渠道更便宜」的定位一致。
+
+## 4. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。本渠道没有这两个字段。
+- **不要把 `nano-banana-fast` 收进本模型的渠道枚举**，它属于已排除的初代「香蕉」命名，见第 1 节与 [Grsai 基础文档 §7](../供应商/Grsai.md)。
+- 代码没有暴露分辨率参数（见第 2 节），本渠道上分辨率参数的真实行为（报错 / 静默降级 / 直接忽略）未实测，接入前建议先用真实任务核实是否真的可以传 `imageSize` 拿到更高分辨率。
+- `pricing.calculator` 固定返回区间上限（无优惠价）¥0.044。
+- 与 [Nano Banana 2 主模型的 Grsai 文档](../Nano-Banana-2/Nano-Banana-2_Grsai.md) 共享同一套响应结构、状态枚举、结果链接有效期等不确定项，见 [Grsai 基础文档](../供应商/Grsai.md) 第 3、8 节，不在本文件重复。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| nano-banana 接口（新版统一生成，含渠道枚举与比例说明） | https://qmy27nhsd9.apifox.cn/452392911e0 | 否 |
+| 异步生成结果查询接口 | https://qmy27nhsd9.apifox.cn/452409577e0 | 否 |
+| Nano Banana API 旧版文档 | https://grsai.ai/zh/dashboard/documents/nano-banana | 否 |
+| dashboard 模型列表（当前权威价格） | https://grsai.com/zh/dashboard/models | 否 |
+| dashboard 公告（`nano-banana-fast` 排除依据的来源公告） | https://grsai.com/zh/dashboard/announcements | 否 |
+| API Key 管理 | https://grsai.ai/zh/dashboard/api-keys | **是** |

package/docs/model-adaptation/Nano-Banana-2-Lite/Nano-Banana-2-Lite_KIE.md

@@ -0,0 +1,64 @@
+# Nano Banana 2 Lite · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-26 |
+| 模态 | 图片 |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID | `nano-banana-2-lite` |
+| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+| 项目对照 | [catalog/kie/nano-banana-2-lite.model.ts](../../../src/catalog/kie/nano-banana-2-lite.model.ts)，`canonicalModelId: 'nano-banana-2-lite'`，与 [Nano Banana 2](../Nano-Banana-2/Nano-Banana-2_KIE.md) 是**两个独立的产品模型**，不是同一模型下的分辨率选项 |
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.kie.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /api/v1/jobs/createTask`，体为 `{ model: 'nano-banana-2-lite', input }`
+- **查询**：`GET /api/v1/jobs/recordInfo?taskId=...`
+- **结果**：`JSON.parse(resultJson)` → `{ resultUrls: [...] }`
+
+## 2. 与 Nano Banana 2 主模型的差异
+
+| 字段 | 主模型（`nano-banana-2`） | Lite（`nano-banana-2-lite`） |
+|---|---|---|
+| 参考图字段名 | `input.image_input` | **`input.image_urls`**（字段名不同，容易写错） |
+| 参考图数量上限 | 14 张 | **10 张** |
+| `input.resolution` | 支持（`1K`/`2K`/`4K`） | **没有** |
+| `input.output_format` | 支持（`jpg`/`png`） | **没有** |
+| `input.aspect_ratio` 必填性 | 可选，默认 `auto` | **必填**，默认 `auto` |
+
+## 3. 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | 必填 | — | 最多 20000 字符 |
+| `input.aspect_ratio` | string | **必填** | `auto` | 15 个取值：`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`（含极端比例，与主模型一致） |
+| `input.image_urls` | array | 可选 | `[]` | 最多 **10 张**。纯文生图可传空数组或不传。支持 `image/jpeg`、`image/png`、`image/webp`；单张 ≤ 30 MB |
+
+## 4. 响应结构
+
+`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`，与主模型完全一致。
+
+## 5. 价格
+
+来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `nano banana`；1 Credit = $0.005）。定价页**未单独列出 `nano-banana-2-lite` 条目**，当前代码固定价 **$0.02/张**（见 [catalog/kie/nano-banana-2-lite.model.ts](../../../src/catalog/kie/nano-banana-2-lite.model.ts) 的 `pricing.calculator`），这个数字未在定价页找到直接对应来源，接入前建议用真实任务核实一次实际扣费。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。本模型没有这两个字段。
+- **参考图字段名与主模型不同**（`image_urls` vs `image_input`），数量上限也不同（10 vs 14），是最容易写错的一处。
+- 没有 `resolution`、没有 `output_format`，不要照抄主模型的参数面板。
+- `aspect_ratio` 在 Lite 上是必填（虽然有默认值 `auto`），建模时仍要按必填处理请求体拼装。
+- `resultJson` 是 JSON 字符串，必须二次 parse，与主模型一致。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Nano Banana 2 Lite | https://docs.kie.ai/cn/market/google/nano-banana-2-lite | 否 |
+| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| 定价页（搜 `nano banana`，未见独立 Lite 条目） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |

package/docs/model-adaptation/Nano-Banana-Pro/Nano-Banana-Pro_APIMart.md

@@ -0,0 +1,83 @@
+# Nano Banana Pro · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 模态 | 图片 |
+| 供应商 | APIMart（聚合平台） |
+| 平台模型 ID | 标准版 `gemini-3-pro-image-preview`（别名 `nano-banana-pro-ext`）<br>官方版 `gemini-3-pro-image-preview-official`（别名 `nano-banana-pro`） |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.apimart.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /v1/images/generations` → `{ code, data: [{ status: "submitted", task_id }] }`
+- **查询**：`GET /v1/tasks/{task_id}`，读 `result.images`
+- **结果时效**：文档标注生成的图像链接 **有效期 24 小时**，请尽快保存
+
+## 2. 能力清单
+
+文生图 / 图生图 / 图像编辑；最多 14 张参考图；1K / 2K / 4K。
+
+> Pro 在 APIMart 上**没有 `google_search` / `google_image_search`**（Nano Banana 2 主模型有），也没有极端宽高比。
+
+## 3. 请求参数（Body）
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必填 | `gemini-3-pro-image-preview` | 标准版 `gemini-3-pro-image-preview`（别名 `nano-banana-pro-ext`）；官方版 `gemini-3-pro-image-preview-official`（别名 `nano-banana-pro`） |
+| `prompt` | string | 必填 | — | 图像生成描述 |
+| `size` | string | 可选 | — | 比例：`auto`、`1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9`（**11 个，无极端比例**）。**`auto` 时文生图默认 `1:1` 或 `16:9`；图生图按上游返回比例为准——建议显式指定** |
+| `resolution` | string | 可选 | `1K` | `1K` / `2K` / `4K`。**用 base64 生成 4K 时处理时间较长** |
+| `n` | integer | 可选 | `1` | **取值只能是 1**。必须传纯数字 |
+| `image_urls` | array | 可选 | — | 参考图。**最多 14 张**；**单张 ≤ 30 MB**（Nano Banana 2 是 10 MB）；格式 .jpeg / .jpg / .png / .webp；支持公网 URL 或完整 Data URI（前缀不能省） |
+| `official_fallback` | boolean | 可选 | `false` | 官方渠道兜底。**使用 `-official` 模型时不能带此参数** |
+| `nsfw_check` | boolean | 可选 | `false` | `true` 时用 `omni-moderation-latest` 预审 |
+
+## 4. 响应结构
+
+提交返回 `{ code, data: [{ status: "submitted", task_id }] }`；轮询 `GET /v1/tasks/{task_id}` 读 `result.images[].url`（数组）。
+
+## 5. 价格
+
+来源：[APIMart 定价中心](https://apimart.ai/zh/pricing)与[Nano Banana 2 模型页](https://apimart.ai/zh/model/nano-banana-2-api)（2026-08-28，1 Credit ≈ $0.1）。
+
+**NANO-BANANA-PRO-EXT**（按张）
+
+| 规格 | 我们的价格 | 官方价 | 节省 |
+|---|---|---|---|
+| 默认（1K / 2K） | 0.3 Credits/张 ≈ **$0.03/张** | $0.0375 | 20% |
+| 4K | 0.4 Credits/张 ≈ **$0.04/张** | $0.05 | 20% |
+
+**NANO-BANANA-PRO**（官方渠道，按 token）
+
+| 计费项 | 我们的价格 | 官方价 |
+|---|---|---|
+| 文本输入 | 16 Credits/M ≈ $1.6/M | $2/M |
+| 图片输入 | 16 Credits/M ≈ $1.6/M | $2/M |
+| 文本输出 | 96 Credits/M ≈ $9.6/M | $12/M |
+| 图片输出 | 960 Credits/M ≈ **$96/M** | $120/M |
+
+SDK 对官方渠道采用模型页当前单张估算：1K/2K **$0.1072**、4K **$0.192**；实际账单仍按 token 结算。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。APIMart 本接口两个字段都没有。
+- `n` 只能是 1；必须是数字类型。
+- 比例集合 11 个，**不包含** Nano Banana 2 的 `1:4` / `4:1` / `1:8` / `8:1`，跨模型不能共用比例集合。
+- 标准版按张计费、官方版按 token 计费，两条渠道的成本模型完全不同。
+- SDK 用首位 `apimartNanoBananaProChannel` 参数表达渠道，默认 `standard` 保持 0.1.5 的 EXT 请求；`official` 只切换精确官方模型 ID，不发送 `official_fallback`。
+- `size: auto` 在文生图与图生图下行为不同，建议永远显式下发。
+- 参考图单张上限 30 MB，比 Nano Banana 2 的 10 MB 宽松。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Nano banana Pro 图像生成 | https://docs.apimart.ai/cn/api-reference/images/gemini-3-pro/generation | 否 |
+| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
+| 定价中心（搜 NANO-BANANA-PRO-EXT / NANO-BANANA-PRO） | https://apimart.ai/zh/pricing | 否 |
+| API Key 管理 | https://apimart.ai/keys | **是** |