@henjicc/ai-sdk 0.8.0 → 0.10.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/Grok-Imagine-Video-1.5/Grok-Imagine-Video-1.5_APIMart.md

@@ -0,0 +1,68 @@
+# Grok Imagine Video 1.5 · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 模态 | 视频 |
+| 供应商 | APIMart（聚合平台） |
+| 项目模型 ID | `apimart-grok-imagine-video-1.5`（通用标识 `grok-imagine-video-1.5`） |
+| 平台模型 ID | 官方：`grok-imagine-video-1.5`；Ext：`grok-imagine-1.5-video-ext` |
+| 接口形态 | 异步任务 |
+| 文档 / 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- 提交：`POST /v1/videos/generations` → `data[0].task_id`
+- 查询：`GET /v1/tasks/{task_id}`，每 3–5 秒；完成后读 `data.result.videos[0].url[0]`，保留 72 小时；失败不收费
+- 官方视频文档提示：不要发送 `X-APIMart-Response-Version`，该头会切到 HTTP 202 新响应结构。项目 provider 统一下发该头并按锁定版本解析（见供应商文档 3.1 节），此处不做模型分支。
+
+## 2. 能力
+
+| 能力 | 官方 `grok-imagine-video-1.5` | Ext `grok-imagine-1.5-video-ext` |
+|---|---|---|
+| 文生视频 | 支持 | 支持 |
+| 参考图生成视频 | `image_urls`，公开契约无固定上限 | `image_urls` ≤ 7 张 |
+| 视频编辑 | 不支持（只有基础版 `grok-imagine-video` 支持） | 不支持 |
+| 分辨率 | `480p` / `720p` / `1080p` | `480p` / `720p` |
+| 时长 | 1–15 秒，默认 8 | 6–15 秒，默认 6 |
+| 比例 | `aspect_ratio`：`1:1` `16:9` `9:16` `4:3` `3:4` `3:2` `2:3` | `size`：`16:9` `9:16` `1:1` `3:2` `2:3`；上传参考图后自动匹配参考图比例 |
+
+## 3. 请求参数
+
+| 字段 | 官方 | Ext |
+|---|---|---|
+| `model` | `grok-imagine-video-1.5` | `grok-imagine-1.5-video-ext` |
+| `prompt` | 必填，去空格后非空，≤ 8000 字符 | 必填 |
+| `duration` | 1–15 | 6–15，纯数字 |
+| `resolution` | 480p / 720p / 1080p，默认 480p | 480p / 720p，默认 480p |
+| 比例 | `aspect_ratio` | `size` |
+| `image_urls` | 公网 HTTPS，无参考图时省略整个字段 | 公网 URL，≤ 7，不支持 base64 |
+| `nsfw_check` | 默认 false | 默认 false |
+
+## 4. 价格
+
+来源：[Grok Imagine Video 1.5 模型页](https://apimart.ai/zh/model/grok-imagine-video-1-5)（2026-11-07 读取，黄金价 = 当前价）。
+
+| 型号 | 规格 | 单价 |
+|---|---|---|
+| 官方 | 480P / 720P / 1080P | $0.064 / $0.112 / $0.2 每秒 |
+| 官方 | 参考图片 | $0.008 / 张 |
+| Ext | 480P / 720P | $0.0102 / $0.01912 每秒 |
+
+Ext 价格表未在模型页价格区单列，取自同页常见问题“2026 年 10 月……Ext 型号为 480p 每秒 $0.0102、720p 每秒 $0.01912”；定价中心起步价 `grok-imagine-1.5-video-ext $0.0102/秒` 一致。Ext 是否对参考图另收费未见说明，项目按不另收估价。
+
+## 5. 项目适配
+
+- 一个产品模型：`role: 'channel'` 渠道（默认官方）；参考图 0 张为文生，1–7 张为参考图生视频（项目把官方也限制为 7 张，与 Ext 一致）。
+- 切到 Ext 时联动裁剪比例与分辨率（无 1080p），时长下限改为 6 秒。
+- 比例默认“智能”：按首图比例取最近支持比例，无图回退 16:9；Ext 发 `size`，官方发 `aspect_ratio`。
+- `nsfw_check` 固定 false。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 官方视频模型 API 文档 | https://docs.apimart.ai/cn/api-reference/videos/grok-imagine/official | 否 |
+| Ext（Grok Imagine 1.5 视频）API 文档 | https://docs.apimart.ai/cn/api-reference/videos/grok-imagine/generation | 否 |
+| 模型页（价格与 Ext FAQ 价格） | https://apimart.ai/zh/model/grok-imagine-video-1-5 | 否 |
+| 定价中心（起步价） | https://apimart.ai/zh/pricing | 否 |

package/docs/model-adaptation/Grok-Imagine-Video-1.5/Grok-Imagine-Video-1.5_Fal.md

@@ -0,0 +1,47 @@
+# Grok Imagine Video 1.5 · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 模态 | 视频 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `xai/grok-imagine-video/v1.5/{text-to-video,image-to-video,reference-to-video}`、`xai/grok-imagine-video/v1.5/lite/{text-to-video,image-to-video}` |
+| 痕迹AI 模型 ID | `fal-ai-grok-imagine-video-1.5`（canonical `grok-imagine-video-1.5`），标准 / Lite 用「版本」切换 |
+| 接口形态 | Fal 队列异步 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 请求参数（OpenAPI，2026-11-07 读取）
+
+| 端点 | 字段 |
+|---|---|
+| 文生（标准 / Lite） | `prompt`（必填，≤4096 字）、`duration`（1–15，默认 6）、`aspect_ratio`（`16:9`/`4:3`/`3:2`/`1:1`/`2:3`/`3:4`/`9:16`，默认 `16:9`）、`resolution`（`480p`/`720p`/`1080p`，默认 `720p`） |
+| 图生（标准 / Lite） | `prompt`（必填）、`image_url`（必填）、`duration`、`resolution`；无 `aspect_ratio` |
+| 参考生视频（仅标准） | `prompt`（必填，用 `<IMAGE_0>` 等引用）、`reference_image_urls`（1–7）、`duration`（默认 8）、`aspect_ratio`、`resolution`（**只有 `480p`/`720p`**，默认 `480p`） |
+
+`enable_safety_checker` 不展示、不下发。响应：`{ "video": { "url" } }`。
+
+## 2. 价格（模型页 pricingInfoOverride，2026-11-07 读取）
+
+| 版本 | 480p | 720p | 1080p | 图片附加 |
+|---|---|---|---|---|
+| 标准 | $0.08/秒 | $0.14/秒 | $0.25/秒 | 每张输入/参考图 +$0.01（1–7 张）；参考音频不另收 |
+| Lite | $0.02/秒 | $0.03/秒 | $0.14/秒 | 图生每张输入图 +$0.01 |
+
+## 3. 适配要点
+
+- 两个主选择器：「版本」（标准 / Lite）与「模式」（文/图生视频、参考生视频；Lite 时隐藏模式，只有文/图生）。
+- 文/图生按是否有图自动路由。
+- 参考生视频不支持 1080p：展示层联动裁掉选项，builder 也会回落到 720p。
+- 智能比例按首图比例匹配最近选项，无图回退 16:9。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 标准文生 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=xai/grok-imagine-video/v1.5/text-to-video | 否 |
+| 标准图生 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=xai/grok-imagine-video/v1.5/image-to-video | 否 |
+| 参考生视频 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=xai/grok-imagine-video/v1.5/reference-to-video | 否 |
+| Lite 文生 / 图生 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=xai/grok-imagine-video/v1.5/lite/text-to-video （图生同理） | 否 |
+| 标准版价格 | https://fal.ai/models/xai/grok-imagine-video/v1.5/text-to-video | 否 |
+| Lite 价格 | https://fal.ai/models/xai/grok-imagine-video/v1.5/lite/image-to-video | 否 |

package/docs/model-adaptation/Grok-Imagine-Video-1.5/Grok-Imagine-Video-1.5_KIE.md

@@ -0,0 +1,37 @@
+# Grok Imagine Video 1.5 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 项目模型 | `kie-grok-imagine-video-1.5`，通用标识 `grok-imagine-video-1.5` |
+| model ID | `grok-imagine-video-1-5-preview`（预览版） |
+| 文档与价格 | 公开，无需登录 |
+| 定价（每秒） | 480p $0.012、720p $0.0225（输出始终带同步音频） |
+
+## 请求契约
+
+`POST https://api.kie.ai/api/v1/jobs/createTask`，`{model,input}`。
+
+| input 字段 | 值与约束 | 项目处理 |
+|---|---|---|
+| prompt | ≤4096；可用 `@image1` 指代参考图 | 统一提示词，英文效果最佳 |
+| image_urls | **schema 必填**，最多 1 张；jpeg/png/webp，≤20MB | 要求上传 1 张图 |
+| aspect_ratio | auto（默认）、1:1、16:9、9:16、4:3、3:4、3:2、2:3 | 展示 |
+| resolution | 480p（默认）、720p、1080p | 价格页只有 480p/720p，1080p 无公开价格，不开放 |
+| duration | 1–15 秒，默认 8 | 数字输入 |
+| first_frame_url / last_frame_url / loop_url / keyframes（≤4） | 首帧、尾帧、循环、带时间戳的中间关键帧 | 与必填的 image_urls 关系文档未说明，本轮不显示、不请求 |
+| enable_audio | 文档字段写默认 true，但页面说明“音频无法关闭” | 不显示、不请求 |
+| nsfw_checker | 可选 | 不发送 |
+
+页面摘要写“文生视频任务”，但 schema 把 `image_urls` 列为必填。项目以 schema 为准，只标图生视频；若后续确认可纯文生视频，再放开图片要求并补 `text-to-video` 标签。
+
+## 事件与失败契约
+
+沿用 [KIE 供应商文档](../供应商/KIE.md) 第 2 节 Market 统一任务契约。官方请求 schema 见 `tests/fixtures/model-requests-2026-11/kie-grok-imagine-video-1.5.json`；未做付费真网验收。
+
+## 原始链接索引
+
+均公开，无需登录：
+- [Grok Imagine Video 1.5 Preview](https://docs.kie.ai/market/grok-imagine/1-5-preview.md)
+- [模型页](https://kie.ai/grok-imagine-video-1.5)
+- [实时价格页](https://kie.ai/pricing)（2026-11-07 核对 480p/720p 两行价格）