@henjicc/ai-sdk 0.2.8 → 0.3.0

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

@@ -1,89 +1,89 @@
-# Nano Banana Pro · Fal
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 图片 |
-| 供应商 | fal.ai（聚合平台） |
-| 平台模型 ID | `fal-ai/nano-banana-pro`、`fal-ai/nano-banana-pro/edit` |
-| 接口形态 | 队列异步（推荐）或同步直连 |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-## 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-pro` |
-| 图像编辑 | `fal-ai/nano-banana-pro/edit` |
-
-> 与 Nano Banana 2 的 `edit` 不同，**Pro 的 `edit` 没有 `video_url` / `audio_url` / `pdf_url` 上下文输入**。
-
-## 3. 请求参数
-
-### 3.1 两个端点共有
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `prompt` | string | 必填 | — | 生成 / 编辑描述 |
-| `num_images` | integer | 可选 | `1` | 1–4 |
-| `seed` | integer | 可选 | 随机 | **本项目规则：绝对不显示**，不下发 |
-| `aspect_ratio` | string | 可选 | 文生图 **`1:1`**；编辑 **`auto`** | `auto`、`21:9`、`16:9`、`3:2`、`4:3`、`5:4`、`1:1`、`4:5`、`3:4`、`2:3`、`9:16`（11 个，**无极端比例**） |
-| `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` | `1K` / `2K` / `4K`（**无 0.5K**，Nano Banana 2 有） |
-| `limit_generations` | boolean | 可选 | **`true`** | 实验性参数：限制每轮提示只出 1 张，**忽略 prompt 中关于生成数量的指令** |
-| `enable_web_search` | boolean | 可选 | `false` | 联网搜索最新信息辅助生成 |
-
-> Pro **没有 `thinking_level`**（Nano Banana 2 有）。
-
-### 3.2 仅 `edit` 有
-
-| 字段 | 类型 | 必填 | 说明 |
-|---|---|---|---|
-| `image_urls` | string[] | **必填** | 用于图生图 / 图像编辑的输入图 URL 列表 |
-
-## 4. 响应结构
-
-```json
-{ "images": [ { "url": "https://...", "content_type": "image/png", "width": 1024, "height": 1024 } ],
-  "description": "（模型对生成图像的描述）" }
-```
-
-## 5. 价格
-
-来源：两个端点的 `llms.txt`（2026-08-22 读取）。Fal 标注 **Pricing may change in the future**。
-
-| 项 | 价格 |
-|---|---|
-| 基础（1K / 2K） | **$0.15 / 张**（$1.00 可跑 7 次） |
-| 4K | 标准价 × **2** = $0.30 / 张 |
-| `enable_web_search` | 额外 **+$0.015** |
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。Fal 本端点**有 `seed`**（不下发），无负面提示词字段。
-- `output_format`、`sync_mode` 不展示、不请求。
-- `aspect_ratio` 的默认值在两个端点上不同（文生图 `1:1`、编辑 `auto`），若要统一行为必须显式下发。
-- `limit_generations` 默认 `true`，会忽略 prompt 中的数量指令。
-- Fal 是四家里最贵的 Nano Banana Pro 渠道（$0.15/张 vs KIE $0.09、APIMart $0.03），成本敏感场景需要注意。
-- `edit` 的 `image_urls` 是必填。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| 文生图模型页 | https://fal.ai/models/fal-ai/nano-banana-pro | 否 |
-| 文生图 schema + 价格 | https://fal.ai/models/fal-ai/nano-banana-pro/llms.txt | 否 |
-| 编辑模型页 | https://fal.ai/models/fal-ai/nano-banana-pro/edit | 否 |
-| 编辑 schema + 价格 | https://fal.ai/models/fal-ai/nano-banana-pro/edit/llms.txt | 否 |
-| 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
-| API Key 创建 | https://fal.ai/dashboard/keys | **是** |
+# Nano Banana Pro · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-22 |
+| 模态 | 图片 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `fal-ai/nano-banana-pro`、`fal-ai/nano-banana-pro/edit` |
+| 接口形态 | 队列异步（推荐）或同步直连 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 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-pro` |
+| 图像编辑 | `fal-ai/nano-banana-pro/edit` |
+
+> 与 Nano Banana 2 的 `edit` 不同，**Pro 的 `edit` 没有 `video_url` / `audio_url` / `pdf_url` 上下文输入**。
+
+## 3. 请求参数
+
+### 3.1 两个端点共有
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `prompt` | string | 必填 | — | 生成 / 编辑描述 |
+| `num_images` | integer | 可选 | `1` | 1–4 |
+| `seed` | integer | 可选 | 随机 | **本项目规则：绝对不显示**，不下发 |
+| `aspect_ratio` | string | 可选 | 文生图 **`1:1`**；编辑 **`auto`** | `auto`、`21:9`、`16:9`、`3:2`、`4:3`、`5:4`、`1:1`、`4:5`、`3:4`、`2:3`、`9:16`（11 个，**无极端比例**） |
+| `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` | `1K` / `2K` / `4K`（**无 0.5K**，Nano Banana 2 有） |
+| `limit_generations` | boolean | 可选 | **`true`** | 实验性参数：限制每轮提示只出 1 张，**忽略 prompt 中关于生成数量的指令** |
+| `enable_web_search` | boolean | 可选 | `false` | 联网搜索最新信息辅助生成 |
+
+> Pro **没有 `thinking_level`**（Nano Banana 2 有）。
+
+### 3.2 仅 `edit` 有
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `image_urls` | string[] | **必填** | 用于图生图 / 图像编辑的输入图 URL 列表 |
+
+## 4. 响应结构
+
+```json
+{ "images": [ { "url": "https://...", "content_type": "image/png", "width": 1024, "height": 1024 } ],
+  "description": "（模型对生成图像的描述）" }
+```
+
+## 5. 价格
+
+来源：两个端点的 `llms.txt`（2026-08-22 读取）。Fal 标注 **Pricing may change in the future**。
+
+| 项 | 价格 |
+|---|---|
+| 基础（1K / 2K） | **$0.15 / 张**（$1.00 可跑 7 次） |
+| 4K | 标准价 × **2** = $0.30 / 张 |
+| `enable_web_search` | 额外 **+$0.015** |
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。Fal 本端点**有 `seed`**（不下发），无负面提示词字段。
+- `output_format`、`sync_mode` 不展示、不请求。
+- `aspect_ratio` 的默认值在两个端点上不同（文生图 `1:1`、编辑 `auto`），若要统一行为必须显式下发。
+- `limit_generations` 默认 `true`，会忽略 prompt 中的数量指令。
+- Fal 是四家里最贵的 Nano Banana Pro 渠道（$0.15/张 vs KIE $0.09、APIMart $0.03），成本敏感场景需要注意。
+- `edit` 的 `image_urls` 是必填。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文生图模型页 | https://fal.ai/models/fal-ai/nano-banana-pro | 否 |
+| 文生图 schema + 价格 | https://fal.ai/models/fal-ai/nano-banana-pro/llms.txt | 否 |
+| 编辑模型页 | https://fal.ai/models/fal-ai/nano-banana-pro/edit | 否 |
+| 编辑 schema + 价格 | https://fal.ai/models/fal-ai/nano-banana-pro/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-Pro/Nano-Banana-Pro_Grsai.md

@@ -1,82 +1,82 @@
-# Nano Banana Pro · Grsai
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-26 |
-| 模态 | 图片 |
-| 供应商 | Grsai（聚合中转，详见 [Grsai 基础文档](../供应商/Grsai.md)） |
-| 平台模型 ID（渠道） | `nano-banana-pro`、`nano-banana-pro-vt`、`nano-banana-pro-cl`、`nano-banana-pro-vip`、`nano-banana-pro-4k-vip` |
-| 接口形态 | 提交 `POST /v1/api/generate` + 轮询 `GET /v1/api/result`（新版统一接口，`replyType` 三选一） |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录（dashboard「模型列表」页） |
-| 项目当前状态 | 已接入，[catalog/grsai/nano-banana-pro.model.ts](../../../src/catalog/grsai/nano-banana-pro.model.ts)，`canonicalModelId: nano-banana-pro` |
-
-> 与 Nano Banana 2 类似，Pro 也拆成 5 个渠道，价差可达 **10 倍**（`nano-banana-pro` ¥0.09 起 vs `nano-banana-pro-4k-vip` 最高 ¥1.8）。特别之处：`nano-banana-pro` 与 `nano-banana-pro-vt` 的积分消耗、价格区间、支持分辨率**完全相同**，大概率是两条互为备份的后端线路，而不是能力差异——这点与 Nano Banana 2 的 `-lite`/`-fast` 重复现象类似。代码里没有假定二者等价并合并成一个选项，而是把 `vt` 保留为独立渠道（标签标注「备用线路」），接入前的实测仍然有价值，但即使证实等价也只是删掉一个选项，不影响其余实现。
-
-## 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`
-
-API 文档把「额外支持 `1:4`/`4:1`/`1:8`/`8:1`」明确标注为「nano-banana-2 系列额外支持」，字面上不包含 Pro 系列——**Pro 系列大概率不支持这四档极端比例，但文档没有反向明确写「Pro 不支持」，接入前需要实测确认**。
-
-## 2. 五个渠道对照
-
-来源：[dashboard 模型列表](https://grsai.com/zh/dashboard/models)（2026-08-26 实测，未登录可见）。价格区间由「积分消耗 × 积分单价区间」得出，下限对应 ¥999 最高档充值套餐（约 5 折），上限对应无优惠单价，详见 [Grsai 基础文档 §5.1](../供应商/Grsai.md)。
-
-| 渠道 | 积分消耗 | 价格区间 | 支持分辨率 | 相对基准倍率 |
-|---|---|---|---|---|
-| `nano-banana-pro` | 1800/次 | ¥0.09~¥0.18/次 | 1K / 2K / 4K | 1×（基准） |
-| `nano-banana-pro-vt` | 1800/次 | ¥0.09~¥0.18/次 | 1K / 2K / 4K | 1×（与基准渠道完全相同，见上方说明） |
-| `nano-banana-pro-cl` | 10000/次 | ¥0.5~¥1/次 | 1K | 5.6× |
-| `nano-banana-pro-vip` | 10000/次 | ¥0.5~¥1/次 | 1K / 2K | 5.6× |
-| `nano-banana-pro-4k-vip` | 18000/次 | ¥0.9~¥1.8/次 | 4K | 10× |
-
-`nano-banana-pro-cl` 与 `nano-banana-pro-vip` 积分消耗和价格区间也完全相同，唯一差异是 `vip` 多支持 2K——即「同价位下 vip 覆盖的分辨率范围更大」，`cl` 目前只保留 1K 档（2026-06-24 公告显示这是调整后的结果，此前 `cl` 支持的分辨率范围更宽，因渠道成本上升被收窄，见第 4 节历史）。
-
-## 3. 响应
-
-结构、状态枚举、结果链接有效期等公共部分见 [Grsai 基础文档](../供应商/Grsai.md) 第 3、8 节，五个渠道共用同一套响应格式，不在本文件重复。
-
-## 4. 价格变动历史（公告原文摘录，供判断渠道稳定性参考）
-
-- 2026-04-14：因 Gemini 官方缩减算力，`cl` 与 `vip` 系渠道被迫更换后端线路，成本上升，两类渠道当日集体涨价
-- 2026-05-20：`nano-banana-2`、`nano-banana-pro` 因谷歌大更新算法变动导致调用失败，数小时后修复恢复
-- 2026-06-19：香蕉系列 2K/4K 分辨率一度因谷歌官方 BUG 无法出图；同日 `nano-banana-pro-vip` 的 2K/4K 分辨率也单独出现过短暂下线又恢复
-- 2026-06-24：「cl 渠道模型」分辨率与价格调整，公告原文点名 `nano-banana-pro-cl` 的分辨率支持范围被收窄（调整后即当前表格里的「仅 1K」）
-- 2026-06-28：「cl 渠道模型」二次调价，公告原文「近期风控严峻导致成本骤升……目前仍处于亏损状态」
-- 2026-07-10 / 2026-08-11：`nano-banana-pro` 与 `nano-banana-2` 因谷歌官方策略/算法变动，各发生过一次数小时到近一天的整体维护/异常，与渠道无关，是模型家族级别的不稳定
-
-`cl` 渠道半年内经历了「分辨率被收窄」+「两次调价」，是本次调研中稳定性证据最弱的渠道；`vip` 渠道价格与 `cl` 相同但保留了更宽的分辨率范围，更贵的 `4k-vip` 与更便宜的基准渠道都发生过官方级别的整体维护，说明「贵=稳」不是绝对规律，只是 `cl` 渠道在公告里被单独点名调整的次数明显更多。
-
-## 5. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。五个渠道文档都没有这两个字段。
-- 五个渠道共享同一套请求/响应结构，做成模型内的「渠道」下拉：字段名按项目约定走 `sharedFieldText('apiChannel')` 并声明 `role: 'channel'`（统一显示「渠道」），选项文案由模型自定义为「标准 / VT（备用线路）/ CL·1K / VIP / VIP·4K」——项目不约束渠道选项文案。
-- 分辨率参数只在「标准/VT/VIP」三个渠道可见，且用 `filterOptions` + `autoSwitch` 联动把 VIP 渠道的可选分辨率收窄到 1K/2K（用户已经选了 4K 时切到 VIP 会自动回退到 2K）；`cl` 与 `4k-vip` 分辨率固定，不显示该控件。
-- `cl` 渠道的分辨率支持范围历史上被官方收窄过一次（2026-06-24），代码按当前 dashboard 页面的「仅 1K」实现，不是假定「支持所有分辨率」；后续官方再调整需要同步改 `channelToModel` 映射表。
-- Pro 系列的比例下拉只暴露 11 档基础比例，**没有**加入 `1:4`/`4:1`/`1:8`/`8:1` 四档极端比例——文档没有反向明确写「Pro 不支持」，但也没写「支持」，按不确定不暴露处理；确认支持后再补选项比确认不支持后再删选项风险更低。
-- `pricing.calculator` 按渠道返回区间上限（无优惠价）：标准/VT ¥0.18，CL·1K/VIP ¥1，VIP·4K ¥1.8。
-
-## 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 Pro · Grsai
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-26 |
+| 模态 | 图片 |
+| 供应商 | Grsai（聚合中转，详见 [Grsai 基础文档](../供应商/Grsai.md)） |
+| 平台模型 ID（渠道） | `nano-banana-pro`、`nano-banana-pro-vt`、`nano-banana-pro-cl`、`nano-banana-pro-vip`、`nano-banana-pro-4k-vip` |
+| 接口形态 | 提交 `POST /v1/api/generate` + 轮询 `GET /v1/api/result`（新版统一接口，`replyType` 三选一） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录（dashboard「模型列表」页） |
+| 项目当前状态 | 已接入，[catalog/grsai/nano-banana-pro.model.ts](../../../src/catalog/grsai/nano-banana-pro.model.ts)，`canonicalModelId: nano-banana-pro` |
+
+> 与 Nano Banana 2 类似，Pro 也拆成 5 个渠道，价差可达 **10 倍**（`nano-banana-pro` ¥0.09 起 vs `nano-banana-pro-4k-vip` 最高 ¥1.8）。特别之处：`nano-banana-pro` 与 `nano-banana-pro-vt` 的积分消耗、价格区间、支持分辨率**完全相同**，大概率是两条互为备份的后端线路，而不是能力差异——这点与 Nano Banana 2 的 `-lite`/`-fast` 重复现象类似。代码里没有假定二者等价并合并成一个选项，而是把 `vt` 保留为独立渠道（标签标注「备用线路」），接入前的实测仍然有价值，但即使证实等价也只是删掉一个选项，不影响其余实现。
+
+## 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`
+
+API 文档把「额外支持 `1:4`/`4:1`/`1:8`/`8:1`」明确标注为「nano-banana-2 系列额外支持」，字面上不包含 Pro 系列——**Pro 系列大概率不支持这四档极端比例，但文档没有反向明确写「Pro 不支持」，接入前需要实测确认**。
+
+## 2. 五个渠道对照
+
+来源：[dashboard 模型列表](https://grsai.com/zh/dashboard/models)（2026-08-26 实测，未登录可见）。价格区间由「积分消耗 × 积分单价区间」得出，下限对应 ¥999 最高档充值套餐（约 5 折），上限对应无优惠单价，详见 [Grsai 基础文档 §5.1](../供应商/Grsai.md)。
+
+| 渠道 | 积分消耗 | 价格区间 | 支持分辨率 | 相对基准倍率 |
+|---|---|---|---|---|
+| `nano-banana-pro` | 1800/次 | ¥0.09~¥0.18/次 | 1K / 2K / 4K | 1×（基准） |
+| `nano-banana-pro-vt` | 1800/次 | ¥0.09~¥0.18/次 | 1K / 2K / 4K | 1×（与基准渠道完全相同，见上方说明） |
+| `nano-banana-pro-cl` | 10000/次 | ¥0.5~¥1/次 | 1K | 5.6× |
+| `nano-banana-pro-vip` | 10000/次 | ¥0.5~¥1/次 | 1K / 2K | 5.6× |
+| `nano-banana-pro-4k-vip` | 18000/次 | ¥0.9~¥1.8/次 | 4K | 10× |
+
+`nano-banana-pro-cl` 与 `nano-banana-pro-vip` 积分消耗和价格区间也完全相同，唯一差异是 `vip` 多支持 2K——即「同价位下 vip 覆盖的分辨率范围更大」，`cl` 目前只保留 1K 档（2026-06-24 公告显示这是调整后的结果，此前 `cl` 支持的分辨率范围更宽，因渠道成本上升被收窄，见第 4 节历史）。
+
+## 3. 响应
+
+结构、状态枚举、结果链接有效期等公共部分见 [Grsai 基础文档](../供应商/Grsai.md) 第 3、8 节，五个渠道共用同一套响应格式，不在本文件重复。
+
+## 4. 价格变动历史（公告原文摘录，供判断渠道稳定性参考）
+
+- 2026-04-14：因 Gemini 官方缩减算力，`cl` 与 `vip` 系渠道被迫更换后端线路，成本上升，两类渠道当日集体涨价
+- 2026-05-20：`nano-banana-2`、`nano-banana-pro` 因谷歌大更新算法变动导致调用失败，数小时后修复恢复
+- 2026-06-19：香蕉系列 2K/4K 分辨率一度因谷歌官方 BUG 无法出图；同日 `nano-banana-pro-vip` 的 2K/4K 分辨率也单独出现过短暂下线又恢复
+- 2026-06-24：「cl 渠道模型」分辨率与价格调整，公告原文点名 `nano-banana-pro-cl` 的分辨率支持范围被收窄（调整后即当前表格里的「仅 1K」）
+- 2026-06-28：「cl 渠道模型」二次调价，公告原文「近期风控严峻导致成本骤升……目前仍处于亏损状态」
+- 2026-07-10 / 2026-08-11：`nano-banana-pro` 与 `nano-banana-2` 因谷歌官方策略/算法变动，各发生过一次数小时到近一天的整体维护/异常，与渠道无关，是模型家族级别的不稳定
+
+`cl` 渠道半年内经历了「分辨率被收窄」+「两次调价」，是本次调研中稳定性证据最弱的渠道；`vip` 渠道价格与 `cl` 相同但保留了更宽的分辨率范围，更贵的 `4k-vip` 与更便宜的基准渠道都发生过官方级别的整体维护，说明「贵=稳」不是绝对规律，只是 `cl` 渠道在公告里被单独点名调整的次数明显更多。
+
+## 5. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。五个渠道文档都没有这两个字段。
+- 五个渠道共享同一套请求/响应结构，做成模型内的「渠道」下拉：字段名按项目约定走 `sharedFieldText('apiChannel')` 并声明 `role: 'channel'`（统一显示「渠道」），选项文案由模型自定义为「标准 / VT（备用线路）/ CL·1K / VIP / VIP·4K」——项目不约束渠道选项文案。
+- 分辨率参数只在「标准/VT/VIP」三个渠道可见，且用 `filterOptions` + `autoSwitch` 联动把 VIP 渠道的可选分辨率收窄到 1K/2K（用户已经选了 4K 时切到 VIP 会自动回退到 2K）；`cl` 与 `4k-vip` 分辨率固定，不显示该控件。
+- `cl` 渠道的分辨率支持范围历史上被官方收窄过一次（2026-06-24），代码按当前 dashboard 页面的「仅 1K」实现，不是假定「支持所有分辨率」；后续官方再调整需要同步改 `channelToModel` 映射表。
+- Pro 系列的比例下拉只暴露 11 档基础比例，**没有**加入 `1:4`/`4:1`/`1:8`/`8:1` 四档极端比例——文档没有反向明确写「Pro 不支持」，但也没写「支持」，按不确定不暴露处理；确认支持后再补选项比确认不支持后再删选项风险更低。
+- `pricing.calculator` 按渠道返回区间上限（无优惠价）：标准/VT ¥0.18，CL·1K/VIP ¥1，VIP·4K ¥1.8。
+
+## 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-Pro/Nano-Banana-Pro_KIE.md

@@ -1,64 +1,64 @@
-# Nano Banana Pro · KIE
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 图片 |
-| 供应商 | KIE.ai（聚合平台） |
-| 平台模型 ID | `nano-banana-pro` |
-| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-> KIE 的文档标题是「Nano Banana Pro 图生图」，路径在 `market/google/pro-image-to-image`，但 `image_input` 是**可选**的——同一个 model 同时承载文生图与图生图。
-
-## 1. 接入协议
-
-- **Base URL**：`https://api.kie.ai`
-- **鉴权**：`Authorization: Bearer <API_KEY>`
-- **提交**：`POST /api/v1/jobs/createTask`，体为 `{ model: "nano-banana-pro", callBackUrl?, input }`
-- **查询**：`GET /api/v1/jobs/recordInfo?taskId=...`
-- **结果**：`JSON.parse(resultJson)` → `{ resultUrls: [...] }`
-
-## 2. 请求参数
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `input.prompt` | string | 必填 | — | 最多 **10000** 字符（Nano Banana 2 是 20000） |
-| `input.image_input` | array | 可选 | — | 输入图。**最多 8 张**（比 APIMart / Fal 的 14 张少）。字段名是 `image_input`。传上传后的文件 URL；支持 `image/jpeg`、`image/png`、`image/webp`；单张 ≤ 30 MB |
-| `input.aspect_ratio` | string | 可选 | **`1:1`** | `1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9`、`auto`（11 个，无极端比例） |
-| `input.resolution` | string | 可选 | `1K` | `1K` / `2K` / `4K` |
-| `input.output_format` | string | 可选 | `png` | `png` / `jpg`（注意是 `jpg` 不是 `jpeg`） |
-
-## 3. 响应结构
-
-`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`。
-
-## 4. 价格
-
-来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `nano banana pro`；1 Credit = $0.005）。
-
-| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
-|---|---|---|---|---|
-| 1/2K | 18.0 /张 | **$0.09/张** | $0.15 | 40% |
-| 4K | 24.0 /张 | **$0.12/张** | $0.3 | 60% |
-
-## 5. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本接口两个字段都没有。
-- `output_format` 默认不显示、不请求；取值是 `jpg` 不是 `jpeg`。
-- **参考图上限只有 8 张**，是所有 Nano Banana Pro 供应商里最少的；跨供应商的上传上限要按供应商取值。
-- 图片字段名是 `image_input`（不是 `image_urls`）。
-- `aspect_ratio` 默认 `1:1`，而 APIMart / Fal 的编辑端点默认 `auto`。
-- 提示词上限 10000 字符。
-- `resultJson` 是 JSON 字符串，必须二次 parse。
-
-## 6. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Nano Banana Pro（图生图页，同时承载文生图） | https://docs.kie.ai/cn/market/google/pro-image-to-image | 否 |
-| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
-| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
-| 定价页（搜 `nano banana pro`） | https://kie.ai/pricing | 否 |
-| API Key 管理 | https://kie.ai/api-key | **是** |
+# Nano Banana Pro · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-22 |
+| 模态 | 图片 |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID | `nano-banana-pro` |
+| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> KIE 的文档标题是「Nano Banana Pro 图生图」，路径在 `market/google/pro-image-to-image`，但 `image_input` 是**可选**的——同一个 model 同时承载文生图与图生图。
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.kie.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /api/v1/jobs/createTask`，体为 `{ model: "nano-banana-pro", callBackUrl?, input }`
+- **查询**：`GET /api/v1/jobs/recordInfo?taskId=...`
+- **结果**：`JSON.parse(resultJson)` → `{ resultUrls: [...] }`
+
+## 2. 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | 必填 | — | 最多 **10000** 字符（Nano Banana 2 是 20000） |
+| `input.image_input` | array | 可选 | — | 输入图。**最多 8 张**（比 APIMart / Fal 的 14 张少）。字段名是 `image_input`。传上传后的文件 URL；支持 `image/jpeg`、`image/png`、`image/webp`；单张 ≤ 30 MB |
+| `input.aspect_ratio` | string | 可选 | **`1:1`** | `1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9`、`auto`（11 个，无极端比例） |
+| `input.resolution` | string | 可选 | `1K` | `1K` / `2K` / `4K` |
+| `input.output_format` | string | 可选 | `png` | `png` / `jpg`（注意是 `jpg` 不是 `jpeg`） |
+
+## 3. 响应结构
+
+`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`。
+
+## 4. 价格
+
+来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `nano banana pro`；1 Credit = $0.005）。
+
+| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
+|---|---|---|---|---|
+| 1/2K | 18.0 /张 | **$0.09/张** | $0.15 | 40% |
+| 4K | 24.0 /张 | **$0.12/张** | $0.3 | 60% |
+
+## 5. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本接口两个字段都没有。
+- `output_format` 默认不显示、不请求；取值是 `jpg` 不是 `jpeg`。
+- **参考图上限只有 8 张**，是所有 Nano Banana Pro 供应商里最少的；跨供应商的上传上限要按供应商取值。
+- 图片字段名是 `image_input`（不是 `image_urls`）。
+- `aspect_ratio` 默认 `1:1`，而 APIMart / Fal 的编辑端点默认 `auto`。
+- 提示词上限 10000 字符。
+- `resultJson` 是 JSON 字符串，必须二次 parse。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Nano Banana Pro（图生图页，同时承载文生图） | https://docs.kie.ai/cn/market/google/pro-image-to-image | 否 |
+| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| 定价页（搜 `nano banana pro`） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |