@henjicc/ai-sdk 0.8.0 → 0.10.0

package/docs/model-adaptation/Topaz-/345/233/276/347/211/207/346/224/276/345/244/247/Topaz-/345/233/276/347/211/207/346/224/276/345/244/247_Fal.md

@@ -1,87 +1,87 @@
-# Topaz 图片放大（Fal）
-
-## 定位
-
-- 端点：`topaz/upscale/image/precision`、`topaz/upscale/image/creative`、`topaz/upscale/image/generative`。
-- 类型：单图输入、单图输出的专业放大工具。
-- 产品边界：精确模式偏忠实放大；创意和生成模式会推断或重建细节，界面不得宣传为“无损”。
-- 官方资料核查日期：2026-08-29；文档公开，无需登录，真实调用需要 Fal API Key。
-
-## 公共协议
-
-| 项目 | 契约 |
-|---|---|
-| Base URL | 队列提交 `https://queue.fal.run/<endpoint-id>` |
-| 鉴权 | `Authorization: Key <FAL_KEY>` |
-| 提交 | `POST /<endpoint-id>`，请求体直接发送模型输入对象 |
-| 查询 | `GET /<endpoint-id>/requests/<request_id>/status` |
-| 结果 | `GET /<endpoint-id>/requests/<request_id>` |
-| 取消 | `PUT /<endpoint-id>/requests/<request_id>/cancel` |
-| 状态 | `IN_QUEUE` → `IN_PROGRESS` → `COMPLETED`；完成后仍需检查错误字段 |
-| 输出 | `image: File`，SDK 复用 Fal 通用 URL 提取与下载链路 |
-
-## 模式与字段
-
-| 模式 | 子模型 | 应用开放字段 | 隐藏或固定字段 |
-|---|---|---|---|
-| Precision | Standard V2、High Fidelity V3/V2、Low Resolution V2、CGI、Text Refine | 模型、2×/4×、人脸增强 | `crop_to_fill=false`；不发送 `output_format`、subject detection、sharpen、denoise 等高级字段 |
-| Creative | Bloom 2、Bloom、Bloom Realism | 模型、2×/4×；Bloom 2 额外开放 creativity 1～9 与颜色保留 | Bloom 2 的 autoprompt 使用 Topaz 默认；不发送 `output_format` |
-| Generative | Wonder 3.5/3/2、Wonder、Recover 3、Standard MAX、Recovery V2/Recovery | 模型、2×/4×、人脸增强；Wonder 3/3.5 开放重建强度 | 不发送 `output_format`、seed、prompt；Redefine 因依赖提示词引导而暂不开放 |
-
-应用默认使用 Precision / High Fidelity V3 / 2×，人脸增强默认关闭。启用人脸增强时固定下发
-`face_enhancement_creativity=0` 与 `face_enhancement_strength=0.8`，优先降低人物身份漂移。
-
-## 请求示例
-
-```json
-{
-  "image_url": "https://example.com/source.jpg",
-  "model": "High Fidelity V3",
-  "upscale_factor": 2,
-  "crop_to_fill": false,
-  "face_enhancement": false
-}
-```
-
-Bloom 2 会按需追加：
-
-```json
-{
-  "creativity": 4,
-  "color_preservation": true
-}
-```
-
-## 价格
-
-Fal 以实际输出像素按“每开始一档”计费，应用在上传前根据源图尺寸与倍率计算预计输出 MP：
-
-| 模式/子模型 | 官方单价 |
-|---|---|
-| Precision | 每开始 24 输出 MP `$0.08` |
-| Creative | 每开始 2 输出 MP `$0.08` |
-| Generative · Wonder 3.5 / Wonder 3 | 每开始 8 输出 MP `$0.08` |
-| Generative · 其他已开放子模型 | 每开始 4 输出 MP `$0.08` |
-
-Topaz 主入口在画布侧限制预计输出不超过 48MP，超过时在上传和创建付费任务前阻止。输入文件沿用应用
-20MiB 安全上限。透明图片改用独立的 Topaz Transparent 或 Bria 模型。
-
-## 适配与验证
-
-- SDK canonical ID：`topaz-image-upscale`；应用模型 ID：`fal-ai-topaz-image-upscale`。
-- 模式通过端点选择器路由，不在宿主或画布 UI 里按模型 ID 拼请求。
-- SDK 通过 `pricing.mediaContext` 声明输入/输出 MP 需求；宿主共享价格层读取源图尺寸并结合倍率计算，生成面板与画布共用，不发送给 Fal。画布执行前预检仍会复核同一输出 MP 与 48MP 上限。
-- 媒体指标尚未读取成功时不显示第一档兜底价，避免 2×/4× 被误报为同价。
-- 已完成端点、请求构建、非法参数回落、单图限制和四种计价档位的离线契约测试；未执行真实付费生成。
-
-## 一手资料
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| Precision API | https://fal.ai/models/topaz/upscale/image/precision/api | 否 |
-| Creative API | https://fal.ai/models/topaz/upscale/image/creative/api | 否 |
-| Generative API | https://fal.ai/models/topaz/upscale/image/generative/api | 否 |
-| Precision OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/precision | 否 |
-| Creative OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/creative | 否 |
-| Generative OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/generative | 否 |
-| API Key | https://fal.ai/dashboard/keys | 是 |
+# Topaz 图片放大（Fal）
+
+## 定位
+
+- 端点：`topaz/upscale/image/precision`、`topaz/upscale/image/creative`、`topaz/upscale/image/generative`。
+- 类型：单图输入、单图输出的专业放大工具。
+- 产品边界：精确模式偏忠实放大；创意和生成模式会推断或重建细节，界面不得宣传为“无损”。
+- 官方资料核查日期：2026-08-29；文档公开，无需登录，真实调用需要 Fal API Key。
+
+## 公共协议
+
+| 项目 | 契约 |
+|---|---|
+| Base URL | 队列提交 `https://queue.fal.run/<endpoint-id>` |
+| 鉴权 | `Authorization: Key <FAL_KEY>` |
+| 提交 | `POST /<endpoint-id>`，请求体直接发送模型输入对象 |
+| 查询 | `GET /<endpoint-id>/requests/<request_id>/status` |
+| 结果 | `GET /<endpoint-id>/requests/<request_id>` |
+| 取消 | `PUT /<endpoint-id>/requests/<request_id>/cancel` |
+| 状态 | `IN_QUEUE` → `IN_PROGRESS` → `COMPLETED`；完成后仍需检查错误字段 |
+| 输出 | `image: File`，SDK 复用 Fal 通用 URL 提取与下载链路 |
+
+## 模式与字段
+
+| 模式 | 子模型 | 应用开放字段 | 隐藏或固定字段 |
+|---|---|---|---|
+| Precision | Standard V2、High Fidelity V3/V2、Low Resolution V2、CGI、Text Refine | 模型、2×/4×、人脸增强 | `crop_to_fill=false`；不发送 `output_format`、subject detection、sharpen、denoise 等高级字段 |
+| Creative | Bloom 2、Bloom、Bloom Realism | 模型、2×/4×；Bloom 2 额外开放 creativity 1～9 与颜色保留 | Bloom 2 的 autoprompt 使用 Topaz 默认；不发送 `output_format` |
+| Generative | Wonder 3.5/3/2、Wonder、Recover 3、Standard MAX、Recovery V2/Recovery | 模型、2×/4×、人脸增强；Wonder 3/3.5 开放重建强度 | 不发送 `output_format`、seed、prompt；Redefine 因依赖提示词引导而暂不开放 |
+
+应用默认使用 Precision / High Fidelity V3 / 2×，人脸增强默认关闭。启用人脸增强时固定下发
+`face_enhancement_creativity=0` 与 `face_enhancement_strength=0.8`，优先降低人物身份漂移。
+
+## 请求示例
+
+```json
+{
+  "image_url": "https://example.com/source.jpg",
+  "model": "High Fidelity V3",
+  "upscale_factor": 2,
+  "crop_to_fill": false,
+  "face_enhancement": false
+}
+```
+
+Bloom 2 会按需追加：
+
+```json
+{
+  "creativity": 4,
+  "color_preservation": true
+}
+```
+
+## 价格
+
+Fal 以实际输出像素按“每开始一档”计费，应用在上传前根据源图尺寸与倍率计算预计输出 MP：
+
+| 模式/子模型 | 官方单价 |
+|---|---|
+| Precision | 每开始 24 输出 MP `$0.08` |
+| Creative | 每开始 2 输出 MP `$0.08` |
+| Generative · Wonder 3.5 / Wonder 3 | 每开始 8 输出 MP `$0.08` |
+| Generative · 其他已开放子模型 | 每开始 4 输出 MP `$0.08` |
+
+Topaz 主入口在画布侧限制预计输出不超过 48MP，超过时在上传和创建付费任务前阻止。输入文件沿用应用
+20MiB 安全上限。透明图片改用独立的 Topaz Transparent 或 Bria 模型。
+
+## 适配与验证
+
+- SDK canonical ID：`topaz-image-upscale`；应用模型 ID：`fal-ai-topaz-image-upscale`。
+- 模式通过端点选择器路由，不在宿主或画布 UI 里按模型 ID 拼请求。
+- SDK 通过 `pricing.mediaContext` 声明输入/输出 MP 需求；宿主共享价格层读取源图尺寸并结合倍率计算，生成面板与画布共用，不发送给 Fal。画布执行前预检仍会复核同一输出 MP 与 48MP 上限。
+- 媒体指标尚未读取成功时不显示第一档兜底价，避免 2×/4× 被误报为同价。
+- 已完成端点、请求构建、非法参数回落、单图限制和四种计价档位的离线契约测试；未执行真实付费生成。
+
+## 一手资料
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| Precision API | https://fal.ai/models/topaz/upscale/image/precision/api | 否 |
+| Creative API | https://fal.ai/models/topaz/upscale/image/creative/api | 否 |
+| Generative API | https://fal.ai/models/topaz/upscale/image/generative/api | 否 |
+| Precision OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/precision | 否 |
+| Creative OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/creative | 否 |
+| Generative OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/generative | 否 |
+| API Key | https://fal.ai/dashboard/keys | 是 |

package/docs/model-adaptation/Topaz-/351/200/217/346/230/216/345/233/276/346/224/276/345/244/247/Topaz-/351/200/217/346/230/216/345/233/276/346/224/276/345/244/247_Fal.md

@@ -1,34 +1,34 @@
-# Topaz 透明图放大（Fal）
-
-## 契约
-
-| 项目 | 内容 |
-|---|---|
-| endpoint ID | `topaz/upscale/image/transparent` |
-| 输入 | `image_url`，应用严格要求 1 张图片 |
-| 输出 | 固定 4×、固定 PNG，保留 alpha 通道；`image: File` |
-| 参数 | 无用户参数；官方 `output_format` 固定为 PNG，应用不重复下发 |
-| 价格 | 每开始 24 输出 MP `$0.08`，按实际固定 4× 输出尺寸估价 |
-| 资料核查 | 2026-08-29；公开，无需登录 |
-
-## 队列与鉴权
-
-使用 `Authorization: Key <FAL_KEY>` 调用 `https://queue.fal.run`：提交后轮询
-`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`，再从结果中的 `image.url` 获取输出；取消使用 endpoint 与
-`request_id` 组成的 `/cancel` 地址。复用 SDK 现有 Fal 上传、轮询、取消和结果解析，不新增协议分支。
-
-## 适配决策
-
-- canonical ID：`topaz-transparent-upscale`；应用模型 ID：`fal-ai-topaz-transparent-upscale`。
-- 该模型独立于 Topaz 主入口，避免把固定 4× 和透明语义伪装成普通倍率选项。
-- `pricing.mediaContext` 声明固定 4× 的输出面积换算，宿主共享价格层读取源图尺寸后按输出 MP 阶梯估价；媒体指标不可用时不显示伪造兜底价。
-- 画布预检允许透明源图，并按相同的 4× 规则复核输出尺寸与价格；输入文件沿用 20MiB 安全上限。
-- 已完成端点、请求体、固定倍率、alpha 预检与像素阶梯计价的离线测试；未执行真实付费生成。
-
-## 一手资料
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| API 文档 | https://fal.ai/models/topaz/upscale/image/transparent/api | 否 |
-| OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/transparent | 否 |
-| API Key | https://fal.ai/dashboard/keys | 是 |
+# Topaz 透明图放大（Fal）
+
+## 契约
+
+| 项目 | 内容 |
+|---|---|
+| endpoint ID | `topaz/upscale/image/transparent` |
+| 输入 | `image_url`，应用严格要求 1 张图片 |
+| 输出 | 固定 4×、固定 PNG，保留 alpha 通道；`image: File` |
+| 参数 | 无用户参数；官方 `output_format` 固定为 PNG，应用不重复下发 |
+| 价格 | 每开始 24 输出 MP `$0.08`，按实际固定 4× 输出尺寸估价 |
+| 资料核查 | 2026-08-29；公开，无需登录 |
+
+## 队列与鉴权
+
+使用 `Authorization: Key <FAL_KEY>` 调用 `https://queue.fal.run`：提交后轮询
+`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`，再从结果中的 `image.url` 获取输出；取消使用 endpoint 与
+`request_id` 组成的 `/cancel` 地址。复用 SDK 现有 Fal 上传、轮询、取消和结果解析，不新增协议分支。
+
+## 适配决策
+
+- canonical ID：`topaz-transparent-upscale`；应用模型 ID：`fal-ai-topaz-transparent-upscale`。
+- 该模型独立于 Topaz 主入口，避免把固定 4× 和透明语义伪装成普通倍率选项。
+- `pricing.mediaContext` 声明固定 4× 的输出面积换算，宿主共享价格层读取源图尺寸后按输出 MP 阶梯估价；媒体指标不可用时不显示伪造兜底价。
+- 画布预检允许透明源图，并按相同的 4× 规则复核输出尺寸与价格；输入文件沿用 20MiB 安全上限。
+- 已完成端点、请求体、固定倍率、alpha 预检与像素阶梯计价的离线测试；未执行真实付费生成。
+
+## 一手资料
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| API 文档 | https://fal.ai/models/topaz/upscale/image/transparent/api | 否 |
+| OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/transparent | 否 |
+| API Key | https://fal.ai/dashboard/keys | 是 |

package/docs/model-adaptation/Veo-3.1/Veo-3.1_APIMart.md

@@ -0,0 +1,90 @@
+# Veo 3.1 · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 模态 | 视频 |
+| 供应商 | APIMart（聚合平台） |
+| 项目模型 ID | `apimart-veo-3.1`（通用标识 `veo-3.1`，与已过时的 `fal-ai-veo-3.1` 相同） |
+| 平台模型 ID | Ext：`veo3.1-fast` / `veo3.1-quality` / `veo3.1-lite`（兼容别名 `-ext` 后缀）；官方：`veo3.1-fast-official` / `veo3.1-quality-official` |
+| 接口形态 | 异步任务 |
+| 文档 / 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- 提交：`POST /v1/videos/generations` → `data[0].task_id`
+- 查询：`GET /v1/tasks/{task_id}`，完成后读 `data.result.videos[0].url[0]`，链接有效 72 小时
+
+## 2. 渠道与能力
+
+| 能力 | Ext Fast | Ext Quality | Ext Lite | 官方 Fast / Quality |
+|---|---|---|---|---|
+| 文生视频 | 支持 | 支持 | 支持 | 支持 |
+| 首帧 / 首尾帧 | `image_urls` 1–2 张，`generation_type: frame` | 同左 | **不支持图片** | `first_frame_image` / `last_frame_image` |
+| 参考图生视频 | `image_urls` ≤ 3，`generation_type: reference` | **不支持** | 不支持 | 不支持 |
+| 时长 | 固定 8 秒 | 固定 8 秒 | 固定 8 秒 | 4 / 6 / 8 秒 |
+| 分辨率 | 720p / 1080p / 4k | 同左 | 同左 | 720p / 1080p / 4K |
+| 音频开关 | 无 | 无 | 无 | `generate_audio`，默认 false |
+
+## 3. 请求参数
+
+### 3.1 Ext
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `model` | `veo3.1-fast` / `veo3.1-quality` / `veo3.1-lite` | |
+| `prompt` | 必填 | |
+| `duration` | 固定 8 | |
+| `aspect_ratio` | `16:9` / `9:16` | |
+| `resolution` | `720p`（默认）/ `1080p` / `4k` | |
+| `generation_type` | `frame` / `reference` | 不传按图片数自动判断；Quality 不支持 reference；Lite 不能传 |
+| `image_urls` | ≤ 3，≤ 10MB，jpeg/jpg/png/webp | Lite 不能传 |
+| `enable_gif` | boolean | 项目不请求 |
+| `official_fallback` | boolean | 项目不请求 |
+| `nsfw_check` | 默认 false | 项目固定 false |
+
+### 3.2 官方
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `model` | `veo3.1-fast-official` / `veo3.1-quality-official` | |
+| `prompt` | 必填，建议英文 | |
+| `duration` | 4 / 6 / 8，默认 8 | 纯数字 |
+| `aspect_ratio` | `16:9` / `9:16` | |
+| `resolution` | `720p` / `1080p` / `4K` | 注意 4K 大写 |
+| `first_frame_image` / `last_frame_image` | 公网 URL | |
+| `generate_audio` | boolean，默认 false | |
+| `negative_prompt` / `seed` / `sample_count` / `person_generation` / `resize_mode` | | 项目不显示、不请求 |
+| `enhance_prompt` | 只能 true | 项目不请求 |
+
+## 4. 价格
+
+来源：[Veo 3.1 模型页](https://apimart.ai/zh/model/veo-3-1)（2026-11-07 读取，黄金价 = 当前价）；定价中心起步价 `veo3.1-fast-ext $0.14/次`、`veo3.1-lite-ext $0.07/次`、`veo3.1-quality-ext $1/次`、`veo3.1-fast-official $0.064/秒`、`veo3.1-quality-official $0.16/秒` 一致。
+
+| 型号 | 720P / 1080P | 4K |
+|---|---|---|
+| Ext Fast | $0.14 / 次 | $0.64 / 次 |
+| Ext Quality | $1 / 次 | $1.5 / 次 |
+| Ext Lite | $0.07 / 次 | $0.57 / 次 |
+
+| 官方（每秒） | 720P | 720P+音频 | 1080P | 1080P+音频 | 4K | 4K+音频 |
+|---|---|---|---|---|---|---|
+| Fast | $0.064 | $0.08 | $0.08 | $0.096 | $0.2 | $0.24 |
+| Quality | $0.16 | $0.32 | $0.16 | $0.32 | $0.32 | $0.48 |
+
+## 5. 项目适配
+
+- Fal 的 Veo 3.1 于 2026-11-17 下线，APIMart 作为替代渠道接入同一通用标识 `veo-3.1`。
+- 一个产品模型：`role: 'channel'` 渠道（默认 Ext）+ `role: 'mode'` 版本（Fast / Quality / Lite；官方渠道联动隐藏 Lite，旧值回到 Fast）。
+- 模式（文/图生视频、参考图生视频）只在 Ext Fast 显示；文/图生视频按图片数：0 张文生，1 张首帧，2 张首尾帧。
+- 时长与音频开关只在官方渠道显示，音频默认开启。
+- 不显示、不请求：`enable_gif`、`official_fallback`、`negative_prompt`、`seed`、`sample_count`、`person_generation`、`resize_mode`、`enhance_prompt`。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Ext API 文档 | https://docs.apimart.ai/cn/api-reference/videos/veo3/generation | 否 |
+| 官方 API 文档 | https://docs.apimart.ai/cn/api-reference/videos/veo3/generation-official | 否 |
+| 模型页（价格） | https://apimart.ai/zh/model/veo-3-1 | 否 |
+| 定价中心（起步价） | https://apimart.ai/zh/pricing | 否 |

package/docs/model-adaptation/Wan-2.7-Image/Wan-2.7-Image_APIMart.md

@@ -0,0 +1,81 @@
+# Wan 2.7 Image · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 图片 |
+| 供应商 | APIMart（聚合平台） |
+| 项目模型 ID | `apimart-wan-2.7-image`（通用标识 `wan-2.7-image`；仓库内其他供应商暂无此模型） |
+| 供应商展示名 | wan2.7-image / wan2.7-image-pro（模型页 `/zh/model/wan-2-7-image`、`/zh/model/wan-2-7-image-pro`） |
+| 平台模型 ID | `wan2.7-image`（标准版）、`wan2.7-image-pro`（Pro） |
+| 接口形态 | 异步任务 |
+| 文档 / 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- 提交：`POST https://api.apimart.ai/v1/images/generations`，`Authorization: Bearer <key>`。
+- 提交响应（官方示例）：`{"code":"success","data":[{"task_id":"task_01HX...","status":"processing"}]}`，取 `data[0].task_id`。
+- 查询：`GET /v1/tasks/{task_id}`，轮询到 `status == completed`；结果在 `data.result.images[].url[]`（APIMart 公共协议，见 `供应商/APIMart.md`）。
+- 错误：400 参数无效、401 鉴权失败、402 余额不足、429 频率限制、500 服务端错误，错误体 `{error:{code,message,type}}`。
+
+## 2. 能力
+
+文生图、图像编辑（传 `image_urls` 自动进入编辑模式）、多图参考（≤ 9 张）、组图（`enable_sequential`，一次生成风格一致的一组图）、交互式框选编辑（`bbox_list`）。
+
+| 版本 | 文生图最高分辨率 | 编辑 / 组图最高分辨率 |
+|---|---|---|
+| `wan2.7-image-pro` | 4K | 2K |
+| `wan2.7-image` | 2K | 2K |
+
+## 3. 请求参数
+
+| 字段 | 类型 / 取值 | 说明 |
+|---|---|---|
+| `model` | 必填，`wan2.7-image` / `wan2.7-image-pro` | |
+| `prompt` | string，≤ 5000 字符 | 文生图必填；编辑模式可选 |
+| `image_urls` | string[]，≤ 9 张 | HTTP(S) 或 `data:image/...;base64`；JPEG/PNG/WEBP/BMP，边长 240–8000 px，宽高比 1:8–8:1，单张 ≤ 20MB；传图后输出比例跟随**最后一张**输入图，编辑模式最高 2K |
+| `n` | integer，默认 1 | 非组图 1–4；组图 1–12；按成功张数计费，提交时按 `n` 预扣 |
+| `size` | string | 档位 `1K`/`2K`(默认)/`4K`，或比例 `1:1` `16:9` `9:16` `4:3` `3:4` `3:2` `2:3`（按 2K 换算），或像素 `1024x1024` |
+| `resolution` | `1K` / `2K` / `4K` | 可与 `size`（比例）配合；4K 仅 Pro 非组图文生图；像素范围标准版与 Pro 编辑/组图 768²–2048²，Pro 文生图 768²–4096² |
+| `enable_sequential` | boolean，默认 false | 组图模式；开启后 `thinking_mode`、`color_palette` 不生效，Pro 组图最高 2K |
+| `thinking_mode` | boolean，默认 true | 仅非组图且无输入图时生效 |
+| `negative_prompt` | string | |
+| `watermark` | boolean，默认 false | 右下角“AI 生成”水印 |
+| `seed` | 0–2147483647 | |
+| `bbox_list` | `[[[x1,y1,x2,y2],...],...]` | 外层长度等于 `image_urls`；无框选的图传 `[]`；每张最多 2 个框，原图绝对像素 |
+| `color_palette` | `[{hex,ratio}]`，3–10 项 | 仅非组图；ratio 之和须为 100.00% |
+| `nsfw_check` | boolean，默认 false | APIMart provider 统一强制 `false` |
+
+## 4. 价格
+
+来源：模型页价格表（2026-11-07 读取，“黄金价 = 当前价格”）；定价中心图像区同值。
+
+| 平台模型 ID | 当前价（黄金） | 铂金 | 钻石 | 官方价 |
+|---|---|---|---|---|
+| `wan2.7-image` | **$0.0216 / 张** | $0.0205 | $0.0194 | $0.027 |
+| `wan2.7-image-pro` | **$0.0544 / 张** | $0.0517 | $0.049 | $0.068 |
+
+- 按成功生成张数 × 单价计费，输入图不计费，与分辨率、比例无关；失败不扣费。
+- **冲突记录**：API 文档正文写 `¥0.20 / 张`、`¥0.50 / 张`（人民币标注），与模型页美元价不一致；按「模型专属页 > 实时价格页 > API 文档正文」取模型页美元价。
+
+## 5. 项目适配
+
+- 一个产品模型：版本（标准 / Pro）`role: 'mode'`，两版共用比例、分辨率、数量与组图参数。
+- 比例默认“智能”：无图时发具体比例（智能回退 `1:1`）到 `size`；有图时不发比例（平台跟随最后一张图）。分辨率发 `resolution`。
+- 4K 只在 Pro + 非组图 + 无输入图时可选（展示联动裁剪菜单并重置；builder 同时拒绝非法组合）。
+- 数量非组图 1–4、组图 1–12；关闭组图时数量超过 4 自动回到 4。
+- 不显示、不请求：`seed`、`negative_prompt`、`watermark`（平台默认 false）、`thinking_mode`（用平台默认 true）、`nsfw_check`（provider 强制 false）。
+- 暂不接：`bbox_list` 框选编辑（需要应用内派生媒体编辑器）、`color_palette`。
+
+- 界面与请求一致（2026-11-08“所选即所发”离线检查）：有输入图时平台按最后一张图定比例、不发送 size，比例参数在带图时隐藏。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| API 文档（中文） | https://docs.apimart.ai/cn/api-reference/images/wan2.7-image/generation | 否 |
+| API 文档（英文） | https://docs.apimart.ai/en/api-reference/images/wan2.7-image/generation | 否 |
+| 任务查询 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
+| 标准版模型页（价格表） | https://apimart.ai/zh/model/wan-2-7-image | 否 |
+| Pro 模型页（价格表） | https://apimart.ai/zh/model/wan-2-7-image-pro | 否 |
+| 定价中心 | https://apimart.ai/zh/pricing | 否 |

package/docs/model-adaptation/Wan-3.0/Wan-3.0_APIMart.md

@@ -0,0 +1,74 @@
+# Wan 3.0 · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 视频 |
+| 供应商 | APIMart（聚合平台） |
+| 项目模型 ID | `apimart-wan-3.0`（通用标识 `wan-3.0`） |
+| 平台模型 ID | `wan3.0-video`、`wan3.0-video-prime`（参数一致，独立型号与价格） |
+| 接口形态 | 异步任务 |
+| 文档 / 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- 提交：`POST /v1/videos/generations` → `data[0].task_id`
+- 查询：`GET /v1/tasks/{task_id}`；通常 1–5 分钟；结果转存平台 CDN，返回地址可长期使用
+- 参数错误均为同步 400，不建任务、不扣费
+
+## 2. 能力（统一入口，按传参自动承接）
+
+| 模式 | 传参 |
+|---|---|
+| 文生视频 | 仅 `prompt` |
+| 首帧 / 首尾帧 | `image_urls` 1 / 2 张（首尾帧族），或 `image_with_roles` |
+| 参考生视频 | 参考图 ≤ 10、参考视频 ≤ 5（单段 1–15 秒，总 ≤ 15 秒）、参考音频 ≤ 5（同上）；`prompt` 用“图1”“视频1”“音频1”指代 |
+| 参考文件 / 网页 | `file_url` 或 `link_url`（二选一，可无 `prompt`） |
+
+首尾帧族与参考族不能混用；裸 `image_urls` 由 `generation_type`（`frame` / `reference`）决定归属，未传时有参考族输入归参考图，否则归首尾帧。
+
+## 3. 请求参数
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `model` | `wan3.0-video` / `wan3.0-video-prime` | 必填 |
+| `prompt` | ≤ 20000 字符（超出自动截断） | 与素材至少填其一 |
+| `resolution` | `480P` / `720P` / `1080P` | **默认 1080P（最贵）**，项目始终显式传 |
+| `size`（或 `aspect_ratio`） | `adaptive` / `16:9` / `4:3` / `1:1` / `3:4` / `9:16` | 默认 `adaptive` |
+| `duration` | 2–30，或 `-1`（模型决定） | 默认 5；有参考视频时输入总时长 + 输出时长 ≤ 30 |
+| `audio` | boolean | 默认 true，开关同价 |
+| `generation_type` | `frame` / `reference` | |
+| `image_urls` / `image_with_roles` / `video_urls` / `audio_urls` / `audio_url` | 公网 URL | 图片单边 240–8000 px；视频 mp4/mov ≤ 100MB；音频 wav/mp3 ≤ 15MB |
+| `file_url` / `link_url` | 文档 / 公开网页 | 项目暂不接入 |
+| `nsfw_check` | boolean | 默认 false，项目固定 false |
+| `seed` / `watermark` | | 项目不显示、不请求 |
+
+## 4. 价格
+
+来源：[Wan 3.0 模型页](https://apimart.ai/zh/model/wan-3-0) 与 [Wan 3.0 Prime 模型页](https://apimart.ai/zh/model/wan-3-0-prime)（2026-11-07 读取，黄金价 = 当前价）；定价中心起步价 `wan3.0-video $0.0329/秒`、`wan3.0-video-prime $0.0514/秒` 一致。
+
+| 分辨率 | wan3.0-video（每秒） | wan3.0-video-prime（每秒） |
+|---|---|---|
+| 480P | $0.03288 | $0.05143 |
+| 720P | $0.06575 | $0.10286 |
+| 1080P | $0.1315 | $0.20571 |
+
+计费按 `duration` 秒数 × 分辨率单价；`duration: -1` 按实际产出秒数；音频开关同价。API 文档写的人民币刊例（480P ¥0.30/秒等）是官方刊例，项目以 APIMart 模型页美元价为准。
+
+## 5. 项目适配
+
+- 素材尺寸前置校验（2026-11-08）：`imageConstraints` 图片单边 240–8000 px。提交前读取素材实际宽高，不合格直接提示，不发付费请求。
+- 一个产品模型，`role: 'mode'` 版本（标准 / Prime）+ `role: 'mode'` 模式（文/图生视频、参考生视频）。
+- 文/图生视频：0 张文生，1 张首帧，2 张首尾帧，显式发 `generation_type: "frame"`；参考模式显式发 `generation_type: "reference"`。
+- 比例默认“智能”→ 发 `adaptive`（平台原生取值，有素材跟随素材）。
+- 分辨率默认 720P 并始终显式发送，避免平台按 1080P 计费。
+- 未接入：`file_url` / `link_url`（APIMart 没有文档上传端点）、`duration: -1`、`seed`、`watermark`。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| API 文档 | https://docs.apimart.ai/cn/api-reference/videos/wan3.0-video/generation | 否 |
+| Wan 3.0 模型页（价格） | https://apimart.ai/zh/model/wan-3-0 | 否 |
+| Wan 3.0 Prime 模型页（价格） | https://apimart.ai/zh/model/wan-3-0-prime | 否 |
+| 定价中心（起步价） | https://apimart.ai/zh/pricing | 否 |

package/docs/model-adaptation/Wan-3.0/Wan-3.0_Fal.md

@@ -0,0 +1,60 @@
+# Wan 3.0（含 Prime）· Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 模态 | 视频 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `alibaba/wan-3.0/{text-to-video,image-to-video,reference-to-video}`、`alibaba/wan-3.0-prime/{同上}` |
+| 痕迹AI 模型 ID | `fal-ai-wan-3.0`（canonical `wan-3.0`），标准 / Prime 用「版本」切换 |
+| 接口形态 | Fal 队列异步 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 请求参数（OpenAPI，2026-11-07 读取；标准与 Prime 字段相同）
+
+| 字段 | 类型 | 必填 | 默认 | 说明 |
+|---|---|---|---|---|
+| `prompt` | string | 文生必填 | — | 最长 20000 字；参考模式用「Image 1 / Video 1」按位置指代 |
+| `resolution` | string | 否 | `1080p` | `480p` / `720p` / `1080p` |
+| `aspect_ratio` | string | 否 | `adaptive` | `adaptive` / `16:9` / `4:3` / `1:1` / `3:4` / `9:16` |
+| `duration` | integer \| null | 否 | `5` | 2–30；`null` 为智能时长（未接入） |
+| `audio` | boolean | 否 | `true` | 生成声音 |
+| `enable_prompt_expansion` | boolean | 否 | `true` | 关闭可省 20–60 秒，但通常降低质量 |
+| `enable_thinking` | boolean | 否 | `false` | 生成前推理 |
+| `seed` / `enable_safety_checker` | | 否 | | 不展示、不下发 |
+| `start_image_url` | string | 图生必填 | — | 首帧 |
+| `end_image_url` | string | 否 | — | 尾帧，需要首帧 |
+| `reference_image_urls` | array | 参考 | — | 最多 10 |
+| `reference_video_urls` | array | 参考 | — | 最多 5，合计 ≤15 秒，每段 ≥16fps；**输入视频时长另计费** |
+| `reference_audio_urls` | array | 参考 | — | 最多 5，合计 ≤15 秒 |
+| `web_url` / `file_url` | string | 参考 | — | 需要 `enable_thinking=true`；未接入 |
+
+响应：`{ "video": { "url" }, "seed", "duration", "actual_prompt" }`。
+
+## 2. 价格（模型页 pricingInfoOverride，2026-11-07 读取；页面注明价格可能调整）
+
+| 版本 | 480p | 720p | 1080p |
+|---|---|---|---|
+| 标准 | $0.05/秒 | $0.10/秒 | $0.20/秒 |
+| Prime | $0.068/秒 | $0.14/秒 | $0.28/秒 |
+
+参考生视频的参考视频输入时长与输出时长一起计费。
+
+## 3. 适配要点
+
+- 一个模型、两个主选择器：「版本」（标准 / Prime，切端点前缀）与「模式」（文/图生视频、参考生视频）。
+- 文/图生视频按图片数自动路由：0 张文生、1 张首帧、2 张首尾帧。
+- 智能比例下发 `adaptive`，交给平台按素材与提示词决定。
+- 计价：`单价 × (输出时长 + 参考视频总时长)`。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 标准文生视频 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=alibaba/wan-3.0/text-to-video | 否 |
+| 标准图生视频 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=alibaba/wan-3.0/image-to-video | 否 |
+| 标准参考生视频 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=alibaba/wan-3.0/reference-to-video | 否 |
+| Prime 文生 / 图生 / 参考 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=alibaba/wan-3.0-prime/text-to-video （另两个端点同理） | 否 |
+| 标准版价格 | https://fal.ai/models/alibaba/wan-3.0/text-to-video | 否 |
+| Prime 价格 | https://fal.ai/models/alibaba/wan-3.0-prime/text-to-video | 否 |

package/docs/model-adaptation/Wan-3.0/Wan-3.0_Grsai.md

@@ -0,0 +1,35 @@
+# Wan 3.0 · Grsai
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 项目模型 | `grsai-wan-3.0`，通用标识 `wan-3.0`（Grsai 第一个视频模型） |
+| 平台 model | `wan-3.0`，模型列表标注“官方直连” |
+| 文档与价格 | 公开，无需登录 |
+| 定价（按秒） | 480p 3300、720p 6600、1080p 13200 积分/秒；基础充值档（1 积分 ≈ ¥0.0001）为 ¥0.33/¥0.66/¥1.32 每秒，模型列表按“积分/20000”给出的高额档参考价为 ¥0.165/¥0.33/¥0.66 |
+
+## 请求契约
+
+沿用 [Grsai 供应商文档](../供应商/Grsai.md) 的 `POST /v1/api/generate` + `GET /v1/api/result` 异步轮询（结果同在 `results[].url`），provider 发送边界统一补 `replyType: "async"`。
+
+| 字段 | 值与约束 | 项目处理 |
+|---|---|---|
+| model | `wan-3.0`，必填 | 固定 |
+| prompt | 必填 | 统一提示词 |
+| aspectRatio | 必填：16:9、9:16、21:9、4:3、1:1、3:4 | 智能比例本地转具体值 |
+| resolution | 必填：480p / 720p / 1080p | 展示，默认 720p |
+| duration | 必填：文档写 2–30 秒，接口实际要求大于 2 秒（2026-11-08 实调 2 秒返回 “duration must be greater than 2 seconds”） | 下拉 3–30 |
+| images | 参考图，base64 或 URL，≤10 张；与首尾帧互斥 | 参考模式 |
+| audios | 参考音频，base64 或 URL，≤5 段、每段 ≤15 秒；与首尾帧互斥 | 参考模式 |
+| firstFrame / lastFrame | 首帧、尾帧图片；与 images、audios 互斥 | 文/图生视频模式 |
+| seed | 可选 | 不显示、不请求 |
+
+模型列表说明“参考视频正在兼容中”，接口也没有参考视频字段，本轮不开放视频输入。
+
+## 原始链接索引
+
+均公开，无需登录：
+- [wan-video 接口](https://qmy27nhsd9.apifox.cn/531060669e0.md)
+- [异步生成结果查询接口](https://qmy27nhsd9.apifox.cn/452409577e0)
+- [模型列表与价格](https://grsai.com/zh/dashboard/models)
+- [充值档位](https://grsai.com/zh/dashboard/billing)

package/docs/model-adaptation/Wan-3.0/Wan-3.0_KIE.md

@@ -0,0 +1,38 @@
+# Wan 3.0 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 项目模型 | `kie-wan-3.0`，通用标识 `wan-3.0`；Prime 见 [Wan-3.0-Prime_KIE.md](../Wan-3.0-Prime/Wan-3.0-Prime_KIE.md) |
+| model ID | `wan/3-0-video` |
+| 文档与价格 | 公开，无需登录 |
+| 定价（每秒，按输出时长） | 480p $0.04、720p $0.08、1080p $0.16 |
+
+## 请求契约
+
+`POST https://api.kie.ai/api/v1/jobs/createTask`，`{model,input}`，单一端点。项目用显式模式区分“首尾帧”和“全能参考”，因为两组字段官方规定互斥。
+
+| input 字段 | 值与约束 | 项目处理 |
+|---|---|---|
+| prompt | ≤20000；文生视频必填，其他模式建议填；参考模式用 Image1/Video1/Audio1 指代 | 有内容才发送 |
+| first_frame_url / last_frame_url | 各 1 张；JPEG/PNG(不含透明)/BMP/WEBP；与 reference_* 互斥 | 文/图生视频模式：第 1 张首帧、第 2 张尾帧 |
+| reference_image_urls | ≤10 张 | 参考模式 |
+| reference_video_urls | ≤5 段，每段 1–15 秒、合计 ≤15 秒；mp4/mov，≤100MB；参考视频时长 + duration ≤ 30 | 参考模式（时长组合由服务端校验） |
+| reference_audio_urls | ≤5 段，每段 1–15 秒、合计 ≤15 秒；wav/mp3，≤15MB；可单独作为输入 | 参考模式 |
+| reference_file_urls / reference_link_urls | 文档或网页生成视频 | 本轮不显示、不请求 |
+| resolution | 480P / 720P / 1080P，默认 1080P | 界面小写，请求转大写；应用默认 720p |
+| aspect_ratio | adaptive（默认）、16:9、4:3、1:1、3:4、9:16 | 直接展示 adaptive |
+| duration | 无视频输入 2–30，默认 5；`-1` 为模型自定时长 | 下拉 2–30；`-1` 无法预估价格，不开放 |
+| audio | 是否带音轨，默认 true | 开关 |
+| seed / nsfw_checker | 可选 | 不显示、不请求 |
+
+## 事件与失败契约
+
+沿用 [KIE 供应商文档](../供应商/KIE.md) 第 2 节 Market 统一任务契约，未引入新轮询或解析分支。官方请求 schema 见 `tests/fixtures/model-requests-2026-11/kie-wan-3.0.json`；未做付费真网验收。
+
+## 原始链接索引
+
+均公开，无需登录：
+- [Wan 3.0 Video](https://docs.kie.ai/market/wan/3-0-video.md)
+- [模型页](https://kie.ai/wan3.0-video)
+- [实时价格页](https://kie.ai/pricing)（2026-11-07 核对 3 行 wan 3.0 video 价格）