@henjicc/ai-sdk 0.2.8 → 0.3.0

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

@@ -1,79 +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 | **是** |
+# 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

@@ -1,65 +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 | **是** |
+# 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

@@ -1,64 +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 | **是** |
+# 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

@@ -1,83 +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 | **是** |
+# 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 | **是** |