@henjicc/ai-sdk 0.2.8 → 0.4.0

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

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

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

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