@henjicc/ai-sdk 0.2.8

package/docs/model-adaptation/Grok-Imagine-2.0/Grok-Imagine-2.0_Fal.md

@@ -0,0 +1,84 @@
+# Grok Imagine 2.0 · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 图片 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `xai/grok-imagine-image/v2.0/text-to-image`、`xai/grok-imagine-image/v2.0/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 |
+|---|---|
+| 文生图 | `xai/grok-imagine-image/v2.0/text-to-image` |
+| 图像编辑（最多 3 张输入图） | `xai/grok-imagine-image/v2.0/edit` |
+
+> Fal 上 Grok Imagine 2.0 **没有分割 / 选区编辑端点**（APIMart 与 KIE 有）。
+
+## 3. 请求参数（两个端点共有）
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `prompt` | string | 必填 | — | 图像描述 |
+| `num_images` | integer | 可选 | `1` | 1–4 |
+| `aspect_ratio` | string | 可选 | 文生图 **`1:1`**；编辑 **`auto`** | `2:1`、`20:9`、`19.5:9`、`16:9`、`4:3`、`3:2`、`1:1`、`2:3`、`3:4`、`9:16`、`9:19.5`、`9:20`、`1:2`（编辑端点另有 `auto`——保持第一张输入图的比例） |
+| `resolution` | string | 可选 | `1k` | `1k`（标准）/ `2k`（高清） |
+| `output_format` | string | 可选 | `jpeg` | `jpeg` / `png` / `webp` |
+| `sync_mode` | boolean | 可选 | `false` | `true` 时以 data URI 返回且不入请求历史 |
+| `quality` | string | 可选 | `medium` | `low` / `medium`。**Fal 在编辑端点也允许发 `quality`**（APIMart 官方渠道明确禁止编辑时发 `quality`） |
+
+**仅 `edit` 有：**
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `image_urls` | string[] | **可选** | 要编辑的图片 URL 列表，**最多 3 张** |
+
+## 4. 响应结构
+
+```json
+{ "images": [ { "url": "https://...", "content_type": "image/jpeg", "width": 1024, "height": 1024 } ],
+  "revised_prompt": "（模型实际使用的增强提示词，可选字段）" }
+```
+
+## 5. 价格
+
+来源：两个端点的 `llms.txt`（2026-08-30 重新核对）。
+
+| 分辨率 | `quality: low` | `quality: medium` |
+|---|---|---|
+| 1K | **$0.04 / 张** | **$0.06 / 张** |
+| 2K | **$0.06 / 张** | **$0.08 / 张** |
+
+`edit` 端点在此基础上**每张输入图 +$0.01**。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。Fal 本端点两个字段都没有。
+- `output_format`、`sync_mode` 不展示、不请求。
+- `aspect_ratio` 默认值在两个端点上不同（文生图 `1:1`、编辑 `auto`）。
+- 比例集合有 13–14 种，含 `9:19.5`、`20:9` 等罕见比例，与 KIE（5–6 种）差距极大。
+- `quality` 与 `resolution` 共同决定价格（4 个组合），成本估算要覆盖。
+- 编辑输入图加价必须按三个运行场景中的最大有效图片数量估算：生成提交的 `uploadedFilePaths`、画布的 `images` 与对话面板的 `uploadedImages`；空字符串和无效项不计数，较短的旧路径数组不能压住较新的完整图片列表。
+- Fal 没有分割 / 选区编辑，如果产品要做该能力只能走 APIMart 或 KIE。
+- `revised_prompt` 是可选返回字段，可以展示给用户看模型实际用了什么提示词。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文生图模型页 | https://fal.ai/models/xai/grok-imagine-image/v2.0/text-to-image | 否 |
+| 文生图 schema + 价格 | https://fal.ai/models/xai/grok-imagine-image/v2.0/text-to-image/llms.txt | 否 |
+| 编辑模型页 | https://fal.ai/models/xai/grok-imagine-image/v2.0/edit | 否 |
+| 编辑 schema + 价格 | https://fal.ai/models/xai/grok-imagine-image/v2.0/edit/llms.txt | 否 |
+| 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
+| API Key 创建 | https://fal.ai/dashboard/keys | **是** |

package/docs/model-adaptation/Grok-Imagine-2.0/Grok-Imagine-2.0_KIE.md

@@ -0,0 +1,105 @@
+# Grok Imagine 2.0 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-22 |
+| 模态 | 图片 |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID | `grok-imagine-image-2-0/text-to-image`、`grok-imagine-image-2-0/image-edit`、`grok-imagine-image-2-0/segment-map`、`grok-imagine-image-2-0/segment-edit` |
+| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> KIE 上 Grok Imagine 2.0 有 **4 个端点**，其中 `segment-map` + `segment-edit` 是完整的「分割 → 按分割索引编辑」工作流。上一版适配只覆盖了基础生成，这两个端点被遗漏。
+
+## 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: [...] }`，分割类为 `{ resultObject: {...} }`
+
+## 2. 能力清单
+
+| 能力 | model |
+|---|---|
+| 文生图 | `grok-imagine-image-2-0/text-to-image` |
+| 图片编辑（1–5 张参考图） | `grok-imagine-image-2-0/image-edit` |
+| **分割图**（拿到对象分割结果） | `grok-imagine-image-2-0/segment-map` |
+| **按分割索引编辑** | `grok-imagine-image-2-0/segment-edit` |
+
+## 3. 请求参数
+
+### 3.1 `grok-imagine-image-2-0/text-to-image`
+
+| 字段 | 类型 | 必填 | 取值与说明 |
+|---|---|---|---|
+| `input.prompt` | string | 必填 | 图像描述 |
+| `input.aspect_ratio` | string | **必填** | **只有 5 个**：`1:1`、`2:3`、`3:2`、`16:9`、`9:16`（**没有 `auto`**） |
+
+文生图端点**没有 `n`、`resolution`、`quality`**。
+
+### 3.2 `grok-imagine-image-2-0/image-edit`
+
+> 该端点的文档页路径是 `.../image-to-image`，但 `model` 值与 `operationId` 都是 **`image-edit`**。
+
+| 字段 | 类型 | 必填 | 取值与说明 |
+|---|---|---|---|
+| `input.image_urls` | array | **必填** | 参考图 URL 数组，**1–5 张**（比 APIMart 官方渠道的 3 张多） |
+| `input.aspect_ratio` | string | **必填** | `1:1`、`2:3`、`3:2`、`16:9`、`9:16`、**`auto`**（6 个） |
+| `input.prompt` | string | 可选 | 最多 **390000** 字符（异常宽松，疑似文档写错，接入前实测） |
+
+### 3.3 `grok-imagine-image-2-0/segment-map`（分割图）
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `input` | object | 必填 | **`oneOf` 两种形态，二选一**：<br>① `{ "task_id": "task_grok_imagine_..." }` —— 对现有任务的图做分割<br>② `{ "image_url": "https://..." }` —— 对指定参考图做分割 |
+
+### 3.4 `grok-imagine-image-2-0/segment-edit`（按分割索引编辑）
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `input.prompt` | string | 必填 | 描述所需图像的提示词 |
+| `input.task_id` | string | 必填 | 源任务 ID。可以是 `grok-imagine-image-2-0/text-to-image` 生成的 taskId，**也可以是 `segment-map` 通过 `image_url` 生成的 taskId** |
+| `input.mask_indexs` | array | 可选 | 要使用的分段数组项的**索引编号**（至少 1 项）。注意字段名拼写是 `mask_indexs`（少一个 e） |
+
+## 4. 响应结构
+
+- 普通生成 / 编辑：`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`
+- 分割类：`resultJson` 走 `{ "resultObject": {...} }` 形态（KIE 通用任务详情文档明确：文本 / 结构化结果用 `resultObject`）
+
+## 5. 价格
+
+来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `grok`；1 Credit = $0.005）。
+
+| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
+|---|---|---|---|---|
+| `grok-imagine-image-2-0`, Text to Image | 4 /张 | **$0.02/张** | $0.06 | 66.7% |
+| `grok-imagine-image-2-0`, Image Edit | 4 /张 | **$0.02/张** | $0.06 | 66.7% |
+
+定价页未单独列出 `segment-map` / `segment-edit` 的价格档位，接入前需确认这两个动作如何计费。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本组接口都没有这两个字段。
+- **4 个端点里有 2 个是分割工作流**，`segment-map` → 拿分割索引 → `segment-edit` 按索引编辑，必须作为独立能力分支，不能塞进普通出图。
+- `aspect_ratio` 在文生图端点是**必填且无 `auto`**，在编辑端点才有 `auto`——两个端点的比例集合不同。
+- 文生图没有分辨率/质量档位，比 APIMart 官方渠道和 Fal 都少。
+- 编辑端点参考图上限 5 张，比 APIMart（3 张）和 Fal（3 张）都多。
+- `mask_indexs` 字段名拼写不规范，容易写成 `mask_indexes`。
+- `image-edit` 的 `prompt` 上限标注 390000 字符，明显异常，接入前实测确认。
+- `resultJson` 是 JSON 字符串，必须二次 parse；分割类走 `resultObject` 而不是 `resultUrls`。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Grok Imagine Image 2.0 文生图 | https://docs.kie.ai/cn/market/grok-imagine-image-2-0/text-to-image | 否 |
+| Grok Imagine Image 2.0 图片编辑 | https://docs.kie.ai/cn/market/grok-imagine-image-2-0/image-to-image | 否 |
+| Grok Imagine Image 2.0 Segment Map | https://docs.kie.ai/cn/market/grok-imagine-image-2-0/segment-map | 否 |
+| Grok Imagine Image 2.0 Segment Edit | https://docs.kie.ai/cn/market/grok-imagine-image-2-0/image-edit | 否 |
+| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| 定价页（搜 `grok`） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |

package/docs/model-adaptation/Hailuo-02/Hailuo-02_Fal.md

@@ -0,0 +1,93 @@
+# MiniMax Hailuo 02 · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 视频 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `fal-ai/minimax/hailuo-02/{standard,pro}/{text-to-video,image-to-video}`、`fal-ai/minimax/hailuo-02-fast/image-to-video` |
+| 接口形态 | 队列异步（推荐）或同步直连 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 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 | 分辨率 | 时长 |
+|---|---|---|---|
+| 无图片，Standard | `fal-ai/minimax/hailuo-02/standard/text-to-video` | 端点不接收 `resolution`（按官方 `$0.045/秒` 计价） | 6 / 10 秒 |
+| 无图片，Pro | `fal-ai/minimax/hailuo-02/pro/text-to-video` | 固定 1080P | 固定 6 秒 |
+| 1 张图片且开启 Fast；版本选择不参与路由 | `fal-ai/minimax/hailuo-02-fast/image-to-video` | 固定 512P | 6 / 10 秒 |
+| 1～2 张图片、关闭 Fast、Standard | `fal-ai/minimax/hailuo-02/standard/image-to-video` | 512P / 768P | 6 / 10 秒 |
+| 1～2 张图片、关闭 Fast、Pro | `fal-ai/minimax/hailuo-02/pro/image-to-video` | 固定 1080P | 固定 6 秒 |
+
+路由判定顺序：
+
+1. 无图时按 Standard / Pro 选择文生视频，Fast 开关无效。
+2. 恰有 1 张图且开启 Fast 时，**Fast 路由优先于版本选择**，统一进入 `hailuo-02-fast/image-to-video`。
+3. 其余图生请求再按 Standard / Pro 选择 non-fast 端点；2 张图的首尾帧请求不能进入 Fast。
+
+## 3. 请求参数
+
+| 字段 | 类型 | 适用端点 | 说明 |
+|---|---|---|---|
+| `prompt` | string | 全部 | 视频描述 |
+| `duration` | string / integer | Standard 与 Fast | `6` / `10`；只有 non-fast Pro 固定 6 秒且不发送该字段，单图 + Fast 即使版本值残留为 Pro 也仍发送 |
+| `resolution` | string | non-fast Standard 图生视频 | `512P` / `768P`；Fast 固定 512P，Pro 固定 1080P |
+| `prompt_optimizer` | boolean | 全部 | 是否优化提示词，默认开启 |
+| `image_url` | string | 图生视频 | 首帧图 URL |
+| `end_image_url` | string | non-fast 图生视频 | 可选尾帧图；提供后形成首尾帧生成 |
+
+Fast 最多接受 1 张图；non-fast 图生视频最多接受首帧、尾帧共 2 张。项目默认不展示、不请求 `seed`、负面提示词和 `output_format`。
+
+## 4. 响应结构
+
+```json
+{
+  "video": {
+    "url": "https://v3b.fal.media/files/.../output.mp4"
+  }
+}
+```
+
+生成结果沿用 Fal 通用 `video.url` 解析、队列轮询、取消与 Fal CDN 上传链路。
+
+## 5. 价格
+
+来源：五个实际端点的实时 `llms.txt`（2026-08-30 读取）。除 Pro 固定 6 秒外，其余按生成视频秒数计费：
+
+| 路由 / 档位 | 单价 | 6 秒 | 10 秒 |
+|---|---:|---:|---:|
+| Fast 图生视频 · 固定 512P | **$0.017 / 秒** | **$0.102** | **$0.17** |
+| non-fast Standard · 图生视频 512P | **$0.017 / 秒** | **$0.102** | **$0.17** |
+| non-fast Standard · 文生（端点无分辨率参数）/ 图生 768P | **$0.045 / 秒** | **$0.27** | **$0.45** |
+| non-fast Pro · 固定 1080P、固定 6 秒 | **$0.08 / 秒** | **$0.48 / 条** | 不支持 |
+
+**Fast 计价同样优先于版本。** 只要实际请求满足“1 张图 + Fast”，就应按 512P `$0.017/秒` 计算，不能因为界面仍保留 Pro 值而误算成 `$0.48/条`。无图时则不能套用 Fast 价格。
+
+## 6. 适配要点
+
+- Fast endpoint 不带 Standard / Pro 子路径；版本值在 Fast 路由和价格中都不生效。
+- Standard 文生视频端点不接收 `resolution`；即使界面参数残留为 512P，也必须按该端点的 `$0.045/秒` 计价。
+- non-fast Pro 不接受时长与分辨率选择，固定 1080P、6 秒；单图 + Fast 优先后属于 Fast 路由，仍按选择发送 6 / 10 秒 `duration`。
+- 图片存在性影响路由和计价，必须同时读取生成提交的 `uploadedFilePaths`、画布的 `images`、对话/工具面板的 `uploadedImages`。
+- Standard 512P 与 Fast 512P 单价相同，但 endpoint、输入上限和首尾帧能力不同，不能只凭价格合并路由。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Standard 文生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-02/standard/text-to-video/llms.txt | 否 |
+| Standard 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-02/standard/image-to-video/llms.txt | 否 |
+| Pro 文生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-02/pro/text-to-video/llms.txt | 否 |
+| Pro 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-02/pro/image-to-video/llms.txt | 否 |
+| Fast 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-02-fast/image-to-video/llms.txt | 否 |
+| Fal 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
+| API Key 创建 | https://fal.ai/dashboard/keys | **是** |

package/docs/model-adaptation/Hailuo-02/Hailuo-02_KIE.md

@@ -0,0 +1,56 @@
+# Hailuo 02 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 视频 |
+| 供应商 | KIE.ai |
+| 平台模型 ID | `hailuo/02-text-to-video-standard`、`hailuo/02-image-to-video-standard`、`hailuo/02-text-to-video-pro`、`hailuo/02-image-to-video-pro` |
+| 接口形态 | `POST /api/v1/jobs/createTask` + `GET /api/v1/jobs/recordInfo` |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 路由与规格
+
+| 输入 | 规格 | 模型 |
+|---|---|---|
+| 无图 | 6/10 秒、768P | `hailuo/02-text-to-video-standard` |
+| 1–2 张图 | 6/10 秒、512P/768P | `hailuo/02-image-to-video-standard` |
+| 无图 | 6 秒、1080P | `hailuo/02-text-to-video-pro` |
+| 1 张图 | 6 秒、1080P | `hailuo/02-image-to-video-pro` |
+
+约束：
+
+- 512P 价格只有图生视频 Standard 分支；文生视频 Standard 固定按 768P 计价，请求也不发送 `resolution`。
+- 1080P 只有 Pro 6 秒档；不存在 `10 秒 + 1080P`。遇到历史参数组合时，运行时必须回收到 10 秒 768P，不得带着 1080P 下发或估价。
+- 首尾帧仍走 Standard 图生视频端点，第二张图映射为 `end_image_url`。
+
+## 2. 价格
+
+KIE 公开定价使用积分，`1 Credit = $0.005`。
+
+| 组合 | Credits | 美元价格 |
+|---|---:|---:|
+| Standard 文生 / 图生，6s 768P | 30 / 条 | $0.15 |
+| Standard 文生 / 图生，10s 768P | 50 / 条 | $0.25 |
+| Standard 图生，6s 512P | 12 / 条 | $0.06 |
+| Standard 图生，10s 512P | 20 / 条 | $0.10 |
+| Pro 文生 / 图生，6s 1080P | 57 / 条 | $0.285 |
+
+SDK 应按实际路由计价：文生视频即使收到残留的 `512P` 参数，也必须按 768P 计价。
+
+## 3. 项目策略
+
+- 模型 schema 保留通用时长和分辨率控件，非法的 10s 1080P 会被联动回收到 768P。
+- builder 和 pricing 使用同一套有效规格归一化，防止 UI、旧工程或外部 SDK 消费方绕过联动后发生低估。
+- 这些价格以美元记录；人民币展示由宿主使用用户汇率换算。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| Standard 文生视频 | https://docs.kie.ai/cn/market/hailuo/02-text-to-video-standard | 否 |
+| Standard 图生视频 | https://docs.kie.ai/cn/market/hailuo/02-image-to-video-standard | 否 |
+| Pro 文生视频 | https://docs.kie.ai/cn/market/hailuo/02-text-to-video-pro | 否 |
+| Pro 图生视频 | https://docs.kie.ai/cn/market/hailuo/02-image-to-video-pro | 否 |
+| 模型专页 | https://kie.ai/hailuo-api | 否 |
+| 当前定价 | https://kie.ai/pricing | 否 |

package/docs/model-adaptation/Hailuo-2.3/Hailuo-2.3_Fal.md

@@ -0,0 +1,88 @@
+# MiniMax Hailuo 2.3 · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 视频 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `fal-ai/minimax/hailuo-2.3/{standard,pro}/{text-to-video,image-to-video}`、`fal-ai/minimax/hailuo-2.3-fast/{standard,pro}/image-to-video` |
+| 接口形态 | 队列异步（推荐）或同步直连 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 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 | 时长 |
+|---|---|---|---|
+| 无图片；`fast` 开关无效 | Standard | `fal-ai/minimax/hailuo-2.3/standard/text-to-video` | 6 / 10 秒 |
+| 无图片；`fast` 开关无效 | Pro | `fal-ai/minimax/hailuo-2.3/pro/text-to-video` | 固定 6 秒 |
+| 有图片，关闭 `fast` | Standard | `fal-ai/minimax/hailuo-2.3/standard/image-to-video` | 6 / 10 秒 |
+| 有图片，关闭 `fast` | Pro | `fal-ai/minimax/hailuo-2.3/pro/image-to-video` | 固定 6 秒 |
+| 有图片，开启 `fast` | Standard | `fal-ai/minimax/hailuo-2.3-fast/standard/image-to-video` | 6 / 10 秒 |
+| 有图片，开启 `fast` | Pro | `fal-ai/minimax/hailuo-2.3-fast/pro/image-to-video` | 固定 6 秒 |
+
+**路由硬规则：没有图片时始终走 non-fast 文生视频端点。** `fast` 只存在于图生视频；不能因为界面开关为真，就把无图请求定价成 Fast，也不能拼出不存在的 Fast 文生视频路径。
+
+## 3. 请求参数
+
+| 字段 | 类型 | 适用端点 | 说明 |
+|---|---|---|---|
+| `prompt` | string | 全部 | 视频描述 |
+| `duration` | string / integer | Standard | `6` / `10`；Pro 端点固定 6 秒，不发送该字段 |
+| `prompt_optimizer` | boolean | 全部 | 是否优化提示词，默认开启 |
+| `image_url` | string | 图生视频 | 首帧图 URL；图生视频端点必需 |
+
+每次最多使用 1 张输入图。项目默认不展示、不请求 `seed`、负面提示词和 `output_format`。
+
+## 4. 响应结构
+
+```json
+{
+  "video": {
+    "url": "https://v3b.fal.media/files/.../output.mp4"
+  }
+}
+```
+
+生成结果沿用 Fal 通用 `video.url` 解析、队列轮询、取消与 Fal CDN 上传链路。
+
+## 5. 价格
+
+来源：六个实际端点的实时 `llms.txt`（2026-08-30 读取）。Fal 按**每条生成视频**计费：
+
+| 路由 | 6 秒 | 10 秒 |
+|---|---:|---:|
+| non-fast Standard · 文生 / 图生 | **$0.28 / 条** | **$0.56 / 条** |
+| non-fast Pro · 文生 / 图生 | **$0.49 / 条** | 不支持 |
+| Fast Standard · 仅图生 | **$0.19 / 条** | **$0.32 / 条** |
+| Fast Pro · 仅图生 | **$0.33 / 条** | 不支持 |
+
+计价必须先按“是否真的有图片”确定能否进入 Fast，再按 Standard / Pro 和时长选价。无图时即使 `fast=true`，仍使用 non-fast 的 `$0.28/$0.56` 或 `$0.49`。
+
+## 6. 适配要点
+
+- Fast 的正确路径是 `hailuo-2.3-fast/{standard,pro}/image-to-video`，不是 `hailuo-2.3/fast/...`。
+- Standard 支持 6 / 10 秒；Pro 固定 6 秒，不能让 10 秒的界面值参与 Pro 计价。
+- Fast 只有图生视频，路由与计价都必须读取三种实时图片字段：生成提交的 `uploadedFilePaths`、画布的 `images`、对话/工具面板的 `uploadedImages`。
+- 模型的 Standard / Pro、Fast / non-fast 是 endpoint 级差异，不应在宿主层按模型 ID 另写请求或价格分支。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| non-fast Standard 文生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3/standard/text-to-video/llms.txt | 否 |
+| non-fast Standard 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3/standard/image-to-video/llms.txt | 否 |
+| non-fast Pro 文生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3/pro/text-to-video/llms.txt | 否 |
+| non-fast Pro 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3/pro/image-to-video/llms.txt | 否 |
+| Fast Standard 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3-fast/standard/image-to-video/llms.txt | 否 |
+| Fast Pro 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3-fast/pro/image-to-video/llms.txt | 否 |
+| Fal 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
+| API Key 创建 | https://fal.ai/dashboard/keys | **是** |

package/docs/model-adaptation/Hailuo-2.3/Hailuo-2.3_KIE.md

@@ -0,0 +1,51 @@
+# Hailuo 2.3 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 图生视频 |
+| 供应商 | KIE.ai |
+| 平台模型 ID | `hailuo/2-3-image-to-video-standard`、`hailuo/2-3-image-to-video-pro` |
+| 接口形态 | `POST /api/v1/jobs/createTask` + `GET /api/v1/jobs/recordInfo` |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 请求和合法组合
+
+两个端点都要求 1 张输入图片，提交字段为 `prompt`、`image_url`、`duration`、`resolution`。
+
+| 模式 | 6s 768P | 10s 768P | 6s 1080P | 10s 1080P |
+|---|---|---|---|---|
+| Standard | 支持 | 支持 | 支持 | **不支持** |
+| Pro | 支持 | 支持 | 支持 | **不支持** |
+
+`10 秒 + 1080P` 不是 KIE 公开的价格/请求组合。生成页联动会将它回收到 10 秒 768P，SDK builder 和 pricing 也必须做相同归一化。
+
+## 2. 价格
+
+KIE 定价页的精确积分换算为 `1 Credit = $0.005`。
+
+| 模式 | 组合 | Credits | 美元价格 |
+|---|---|---:|---:|
+| Standard | 6s 768P | 30 / 条 | $0.15 |
+| Standard | 10s 768P | 50 / 条 | $0.25 |
+| Standard | 6s 1080P | 50 / 条 | $0.25 |
+| Pro | 6s 768P | 45 / 条 | $0.225 |
+| Pro | 10s 768P | 90 / 条 | $0.45 |
+| Pro | 6s 1080P | 80 / 条 | $0.40 |
+
+模型营销专页将部分精确价格显示为 `$0.26 / $0.22 / $0.39`，与同页 Credits 和当前定价数据不一致。SDK 以当前定价表的 Credits 及其精确美元值为准。
+
+## 3. 项目策略
+
+- 价格表只保留六个官方合法 key，不得把未知 key fallback 到 Standard 6s 768P。
+- 对残留的 `10s + 1080P` 参数，builder 和 pricing 统一回收到 `10s + 768P`。
+- 这些价格以美元记录；人民币展示由宿主使用用户汇率换算。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| Standard 图生视频 | https://docs.kie.ai/cn/market/hailuo/2-3-image-to-video-standard | 否 |
+| Pro 图生视频 | https://docs.kie.ai/cn/market/hailuo/2-3-image-to-video-pro | 否 |
+| 模型专页 | https://kie.ai/hailuo-2-3 | 否 |
+| 当前定价 | https://kie.ai/pricing | 否 |

package/docs/model-adaptation/Hailuo-2.3/Hailuo-2.3_/346/264/276/346/254/247/344/272/221.md

@@ -0,0 +1,70 @@
+# MiniMax Hailuo 2.3 · 派欧云 PPIO
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-26 |
+| 模态 | 视频 |
+| 供应商 | 派欧云 PPIO |
+| 平台路由 | `/v3/async/minimax-hailuo-2.3-{t2v,i2v,fast-i2v}` |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+供应商公共协议见 [供应商/派欧云.md](../供应商/派欧云.md)。
+
+## 1. 能力与价格
+
+**按视频条数计费**：
+
+| 变体 | 路由 | 6s/768P | 10s/768P | 6s/1080P |
+|---|---|---|---|---|
+| 文生视频 | `/v3/async/minimax-hailuo-2.3-t2v` | ¥2 | ¥4 | ¥3.5 |
+| 图生视频 | `/v3/async/minimax-hailuo-2.3-i2v` | ¥2 | ¥4 | ¥3.5 |
+| **Fast** 图生视频 | `/v3/async/minimax-hailuo-2.3-fast-i2v` | ¥1.35 | ¥2.25 | ¥2.3 |
+
+**10 秒档只支持 768P，没有 10s/1080P 组合。** Fast 模式只有图生视频，没有文生视频。
+
+## 2. 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 约束 |
+|---|---|---|---|---|
+| `prompt` | string | ✅ | — | 1–2000，**支持运镜指令，见下** |
+| `image` | string | ✅（i2v / fast-i2v） | — | 公网 URL 或 `data:image/jpeg;base64,...` |
+| `duration` | integer | | `6` | 枚举 `6` / `10` |
+| `resolution` | string | | `768P` | **6s 支持 `768P`/`1080P`；10s 仅 `768P`** |
+| `enable_prompt_expansion` | boolean | | `true` | |
+| `fast_pretreatment` | boolean | | `false` | **fast-i2v 变体没有这个字段** |
+| `aigc_watermark` | boolean | | `false` | |
+
+### 运镜指令（写在 prompt 里）
+
+t2v 与 i2v 的 `prompt` 支持 15 种方括号运镜指令：
+
+```
+[左移] [右移] [左摇] [右摇] [推进] [拉远] [上升] [下降]
+[上摇] [下摇] [变焦推近] [变焦拉远] [晃动] [跟随] [固定]
+```
+
+同一组 `[]` 内组合建议 ≤ 3 个。
+
+> **fast-i2v 的文档里没有写运镜指令说明**，且没有 `fast_pretreatment` 字段——接入时不要假设 fast 变体与标准变体完全等价。
+
+## 3. 上传要求
+
+`image` 字段名不以 `_url` 结尾 → 走默认 **`data-uri` 模式**内联，**不依赖 KIE API Key**。这是 PPIO 视频模型里少见的无外部依赖的情况。
+
+## 4. 适配要点
+
+- `resolution` 与 `duration` 有互斥约束（10s 不能选 1080P），需要用 linkage 的 `filterOptions` + `autoSwitch` 表达，不能只在 builder 里静默回落。
+- Fast 模式只在图生视频下存在，文生视频时该开关应隐藏。
+- 计价维度是 `duration × resolution × 是否 fast`，三个维度都要读。
+- 项目默认隐藏 `seed` 与负面提示词：本模型接口**没有**这两个字段，无需处理。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文生视频 | https://ppio.com/docs/models/reference-minimax-hailuo-2.3-t2v | 否 |
+| 图生视频 | https://ppio.com/docs/models/reference-minimax-hailuo-2.3-i2v | 否 |
+| Fast 图生视频 | https://ppio.com/docs/models/reference-minimax-hailuo-2.3-fast-i2v | 否 |
+| 定价页（视频 tab） | https://ppio.com/pricing | 否 |

package/docs/model-adaptation/IC-Light-v2/IC-Light-v2_Fal.md

@@ -0,0 +1,96 @@
+# IC-Light v2 · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-29 |
+| 模态 | 图片编辑 / 重打光 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `fal-ai/iclight-v2` |
+| 接口形态 | 队列异步（推荐）或同步直连 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 能力与边界
+
+IC-Light v2 接收一张源图，通过文字描述和离散的初始光照偏好重新生成光照。Fal 模型页标注可商用；Fal 托管端点不要求本项目部署开源权重。产品首版只把 `initial_latent` 的五个官方值作为离散方向偏好，亮度、色调和轮廓光均由版本化提示词表达，不能宣称为物理精确控制。
+
+上游 IC-Light 仓库采用 Apache-2.0；仓库同时说明本地示例使用的 BRIA RMBG 1.4 权重具有非商用限制。该限制影响自行部署相应去背景权重的方案，不等同于 Fal 托管端点的产品许可。若未来改为自部署，必须重新完成权重来源与商用许可审查。
+
+## 2. 接入协议
+
+- 鉴权：`Authorization: Key $FAL_KEY`
+- 同步：`POST https://fal.run/fal-ai/iclight-v2`
+- 队列：`POST https://queue.fal.run/fal-ai/iclight-v2`，随后按 Fal 通用队列协议查询状态与结果
+- 成功结果：`images[]`，本项目继续复用 Fal 现有图片结果解析、轮询、取消与上传链路
+
+## 3. 输入参数
+
+| 字段 | 类型 | 必填 | 默认 | 首版策略 |
+|---|---|---|---|---|
+| `prompt` | string | 是 | — | 由手动模式提示词编译器生成 |
+| `image_url` | string | 是 | — | 恰好一张源图，由现有 Fal 上传链路提供 |
+| `initial_latent` | enum | 否 | `None` | 仅 `None` / `Left` / `Right` / `Top` / `Bottom` |
+| `image_size` | enum/object | 否 | `square_hd` | 首版按源图比例选择最近常见比例并固定约 1MP |
+| `num_images` | integer | 否 | `1` | 固定 `1` |
+| `num_inference_steps` | integer | 否 | `28` | 固定 `28` |
+| `cfg_scale` | number | 否 | `1` | 固定 `1` |
+| `guidance_scale` | number | 否 | `5` | 固定 `5` |
+| `lowres_denoise` | number | 否 | `0.98` | 固定 `0.98` |
+| `highres_denoise` | number | 否 | `0.95` | 固定 `0.95` |
+| `highres_scale` | number | 否 | `0.5` | 固定 `0.5` |
+| `enable_hr_fix` | boolean | 否 | `false` | 固定 `false`，首版避免额外成本与时延 |
+| `enable_safety_checker` | boolean | 否 | `true` | 固定 `true` |
+| `mask_url` | string | 否 | — | 首版不开放 |
+| `negative_prompt` | string | 否 | — | 不展示、不发送 |
+| `seed` | integer | 否 | — | 不展示、不发送 |
+| `output_format` | enum | 否 | `png` | 不展示、不发送，沿用供应商默认 |
+
+## 4. 请求示例
+
+```json
+{
+  "prompt": "Preserve the subject and composition. Apply a soft warm key light from the left.",
+  "image_url": "https://.../source.png",
+  "initial_latent": "Left",
+  "image_size": { "width": 1376, "height": 768 },
+  "num_images": 1,
+  "num_inference_steps": 28,
+  "cfg_scale": 1,
+  "guidance_scale": 5,
+  "lowres_denoise": 0.98,
+  "highres_denoise": 0.95,
+  "highres_scale": 0.5,
+  "enable_hr_fix": false,
+  "enable_safety_checker": true
+}
+```
+
+## 5. 响应与计价
+
+```json
+{
+  "images": [
+    { "url": "https://...", "width": 1376, "height": 768, "content_type": "image/png" }
+  ]
+}
+```
+
+Fal 模型页公开价格为 **$0.10/百万像素**。首版固定约 1MP、单张输出，目录保守估算为 **$0.10/次**。实际账单仍以 Fal 返回和账户账单为准，登录后的额度、地区可用性与最终账单尚待真实验证。
+
+## 6. 错误与降级
+
+- 缺少源图或源图超过一张：在请求构建前失败，不提交任务。
+- Fal 凭据、端点或余额不可用：显示明确失败，不自动切换模型。
+- 手动模式不能静默降级到 GPT Image 2；智能模式也不能静默切到 IC-Light。
+- 模型质量、主体保持、时延和真实成本尚未执行付费验证，不影响静态契约完成。
+
+## 7. 一手来源
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Fal 模型页、商用标识与价格 | https://fal.ai/models/fal-ai/iclight-v2 | 否 |
+| Fal schema | https://fal.ai/models/fal-ai/iclight-v2/llms.txt | 否 |
+| Fal OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/iclight-v2 | 否 |
+| Fal 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
+| IC-Light 官方仓库与许可证 | https://github.com/lllyasviel/IC-Light | 否 |
+| Fal API Key | https://fal.ai/dashboard/keys | 是 |