@henjicc/ai-sdk 0.8.0 → 0.10.0

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

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

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

@@ -1,70 +1,72 @@
-# 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 | **是** |
+# Nano Banana 2 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 图片 |
+| 供应商 | 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)。
+
+- 官方格式核对（2026-11-08）：官方 `image_input` 最多 10 张，参考图上限由 14 改为 10。
+
+## 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 | **是** |