@henjicc/ai-sdk 0.9.0 → 0.10.0

package/docs/model-adaptation/Kling-3.0-Turbo/Kling-3.0-Turbo_APIMart.md

@@ -1,85 +1,88 @@
-# Kling 3.0 Turbo · APIMart
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 视频 |
-| 供应商 | APIMart（聚合平台） |
-| 平台模型 ID | `kling-3.0-turbo` |
-| 接口形态 | **异步任务** |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-| 上游官方模型标识 | `kling-3.0-turbo`（与可灵官方能力地图一致） |
-
-## 1. 接入协议
-
-- **Base URL**：`https://api.apimart.ai`
-- **鉴权**：`Authorization: Bearer <API_KEY>`
-- **提交**：`POST /v1/videos/generations` → `{ code: 200, data: [{ status: "submitted", task_id }] }`
-- **查询**：`GET /v1/tasks/{task_id}`
-
-## 2. 能力清单
-
-文生视频、图生视频（**仅首帧**）、多镜头分镜（**通过固定格式提示词表达**，不是结构化字段）。
-
-> Turbo **没有** `mode`、`negative_prompt`、`audio`、`multi_shot` / `multi_prompt` / `element_list` 这些 `kling-v3` 的结构化字段，也**没有尾帧**。
-
-## 3. 请求参数
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `model` | string | 必填 | — | `kling-3.0-turbo` |
-| `prompt` | string | 必填 | — | 上游限制 **≤ 3072 字符，建议 ≤ 2500 字符**。图生视频时可留空（纯按首帧图生成） |
-| `first_frame_image` | string | 可选 | — | 首帧图。支持**图片 URL 或 Base64**。上游限制：`.jpg` / `.jpeg` / `.png`；**≤ 50 MB**；宽高 **≥ 300 px**；宽高比 `1:2.5` ~ `2.5:1` |
-| `aspect_ratio` | string | 可选 | `16:9` | `16:9`、`9:16`、`1:1`。**仅文生视频生效；图生视频时此字段无效，比例由首帧图决定** |
-| `resolution` | string | 可选 | `720p` | `720p` / `1080p`（**没有 4K**） |
-| `duration` | integer | 可选 | `5` | **3–15 秒**。必须是纯数字，加引号会报错 |
-| `watermark` | boolean | 可选 | — | **仅当显式传入时才下发到上游；不传则不添加水印** |
-| `nsfw_check` | boolean | 可选 | `false` | 提交前内容审核 |
-
-### 文生视频 vs 图生视频
-
-系统按是否提供 `first_frame_image` **自动判断**，用户无需显式声明。
-
-| 参数 | 文生视频 | 图生视频 |
-|---|---|---|
-| `prompt` | ✅ 必填 | ✅ 可选（留空纯按首帧图生成） |
-| `first_frame_image` | ❌ 不传 | ✅ 必填 |
-| `aspect_ratio` | ✅ 可选 | ❌ 无效（比例由首帧图决定） |
-| `resolution` | ✅ 可选 | ✅ 可选 |
-| `duration` | ✅ 可选（3–15） | ✅ 可选（3–15） |
-| `watermark` | ✅ 可选 | ✅ 可选 |
-
-## 4. 响应结构
-
-提交返回 `{ code, data: [{ status: "submitted", task_id }] }`；轮询 `GET /v1/tasks/{task_id}`，成功后读 `result.videos[]`。
-
-## 5. 价格
-
-来源：[APIMart 定价中心](https://apimart.ai/zh/pricing) → 视频标签页 `KLING-3.0-TURBO`（2026-08-22，2 个档位，1 Credit ≈ $0.1）。
-
-| 规格 | 我们的价格 | 官方价 | 节省 |
-|---|---|---|---|
-| 720P | 1.144 Credits/秒 ≈ **$0.1144/秒** | $0.143 | 20% |
-| 1080P | 1.432 Credits/秒 ≈ **$0.1432/秒** | $0.179 | 20% |
-
-> 注意：Turbo 的单价**高于** `kling-v3` 的 std / pro 档（$0.0672 / $0.0896），Turbo 是「更快」不是「更便宜」。
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。APIMart 的 Turbo 接口这两个字段都没有。
-- **图生视频只有首帧，没有尾帧**；`aspect_ratio` 在图生视频下无效，UI 应禁用。
-- 首帧图字段名是 `first_frame_image`（单个字符串），与 `kling-v3` 的 `image_urls`（数组）完全不同，不能共用。
-- 分辨率字段名是 `resolution`（`720p` / `1080p`），而 `kling-v3` 用 `mode`（`std` / `pro` / `4k`）——同一模型家族里两套写法。
-- 多镜头只能靠提示词的固定格式表达，没有结构化分镜字段。
-- `watermark` 不传即不加水印。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Kling 3.0 Turbo 视频生成 | https://docs.apimart.ai/cn/api-reference/videos/kling-3.0-turbo/generation | 否 |
-| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
-| 定价中心（视频标签页搜 KLING-3.0-TURBO） | https://apimart.ai/zh/pricing | 否 |
-| 可灵官方视频能力地图（仅参考） | https://www.klingai.com/document-api/guides/capability-map/video | 否 |
-| API Key 管理 | https://apimart.ai/keys | **是** |
+# Kling 3.0 Turbo · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 视频 |
+| 供应商 | APIMart（聚合平台） |
+| 平台模型 ID | `kling-3.0-turbo` |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+| 上游官方模型标识 | `kling-3.0-turbo`（与可灵官方能力地图一致） |
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.apimart.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /v1/videos/generations` → `{ code: 200, data: [{ status: "submitted", task_id }] }`
+- **查询**：`GET /v1/tasks/{task_id}`
+
+## 2. 能力清单
+
+文生视频、图生视频（**仅首帧**）、多镜头分镜（**通过固定格式提示词表达**，不是结构化字段）。
+
+> Turbo **没有** `mode`、`negative_prompt`、`audio`、`multi_shot` / `multi_prompt` / `element_list` 这些 `kling-v3` 的结构化字段，也**没有尾帧**。
+
+## 3. 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必填 | — | `kling-3.0-turbo` |
+| `prompt` | string | 必填 | — | 上游限制 **≤ 3072 字符，建议 ≤ 2500 字符**。图生视频时可留空（纯按首帧图生成） |
+| `first_frame_image` | string | 可选 | — | 首帧图。支持**图片 URL 或 Base64**。上游限制：`.jpg` / `.jpeg` / `.png`；**≤ 50 MB**；宽高 **≥ 300 px**；宽高比 `1:2.5` ~ `2.5:1` |
+| `aspect_ratio` | string | 可选 | `16:9` | `16:9`、`9:16`、`1:1`。**仅文生视频生效；图生视频时此字段无效，比例由首帧图决定** |
+| `resolution` | string | 可选 | `720p` | `720p` / `1080p`（**没有 4K**） |
+| `duration` | integer | 可选 | `5` | **3–15 秒**。必须是纯数字，加引号会报错 |
+| `watermark` | boolean | 可选 | — | **仅当显式传入时才下发到上游；不传则不添加水印** |
+| `nsfw_check` | boolean | 可选 | `false` | 提交前内容审核 |
+
+### 文生视频 vs 图生视频
+
+系统按是否提供 `first_frame_image` **自动判断**，用户无需显式声明。
+
+| 参数 | 文生视频 | 图生视频 |
+|---|---|---|
+| `prompt` | ✅ 必填 | ✅ 可选（留空纯按首帧图生成） |
+| `first_frame_image` | ❌ 不传 | ✅ 必填 |
+| `aspect_ratio` | ✅ 可选 | ❌ 无效（比例由首帧图决定） |
+| `resolution` | ✅ 可选 | ✅ 可选 |
+| `duration` | ✅ 可选（3–15） | ✅ 可选（3–15） |
+| `watermark` | ✅ 可选 | ✅ 可选 |
+
+## 4. 响应结构
+
+提交返回 `{ code, data: [{ status: "submitted", task_id }] }`；轮询 `GET /v1/tasks/{task_id}`，成功后读 `result.videos[]`。
+
+## 5. 价格
+
+来源：[APIMart 定价中心](https://apimart.ai/zh/pricing) → 视频标签页 `KLING-3.0-TURBO`（2026-08-22，2 个档位，1 Credit ≈ $0.1）。
+
+| 规格 | 我们的价格 | 官方价 | 节省 |
+|---|---|---|---|
+| 720P | 1.144 Credits/秒 ≈ **$0.1144/秒** | $0.143 | 20% |
+| 1080P | 1.432 Credits/秒 ≈ **$0.1432/秒** | $0.179 | 20% |
+
+> 注意：Turbo 的单价**高于** `kling-v3` 的 std / pro 档（$0.0672 / $0.0896），Turbo 是「更快」不是「更便宜」。
+
+## 6. 适配要点
+
+- 素材尺寸前置校验（2026-11-08）：`imageConstraints` 首帧宽高 ≥ 300 px、宽高比 0.4–2.5。提交前读取素材实际宽高，不合格直接提示，不发付费请求。
+- 本项目默认**绝对不显示**：`seed`、负面提示词。APIMart 的 Turbo 接口这两个字段都没有。
+- **图生视频只有首帧，没有尾帧**；`aspect_ratio` 在图生视频下无效，UI 应禁用。
+- 首帧图字段名是 `first_frame_image`（单个字符串），与 `kling-v3` 的 `image_urls`（数组）完全不同，不能共用。
+- 分辨率字段名是 `resolution`（`720p` / `1080p`），而 `kling-v3` 用 `mode`（`std` / `pro` / `4k`）——同一模型家族里两套写法。
+- 多镜头只能靠提示词的固定格式表达，没有结构化分镜字段。
+- `watermark` 不传即不加水印。
+
+- 界面与请求一致（2026-11-08“所选即所发”离线检查）：带首帧时不发送 aspect_ratio（比例跟随首帧），比例参数在带图时隐藏。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Kling 3.0 Turbo 视频生成 | https://docs.apimart.ai/cn/api-reference/videos/kling-3.0-turbo/generation | 否 |
+| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
+| 定价中心（视频标签页搜 KLING-3.0-TURBO） | https://apimart.ai/zh/pricing | 否 |
+| 可灵官方视频能力地图（仅参考） | https://www.klingai.com/document-api/guides/capability-map/video | 否 |
+| API Key 管理 | https://apimart.ai/keys | **是** |

package/docs/model-adaptation/Kling-3.0-Turbo/Kling-3.0-Turbo_Fal.md

@@ -1,83 +1,86 @@
-# Kling 3.0 Turbo · Fal
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 视频 |
-| 供应商 | fal.ai（聚合平台） |
-| 平台模型 ID | `fal-ai/kling-video/v3/turbo/{pro,standard}/{text-to-video,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. 能力清单
-
-| 档位 | 文生视频 | 图生视频 |
-|---|---|---|
-| Turbo Pro（1080P） | `fal-ai/kling-video/v3/turbo/pro/text-to-video` | `fal-ai/kling-video/v3/turbo/pro/image-to-video` |
-| Turbo Standard（720P） | `fal-ai/kling-video/v3/turbo/standard/text-to-video` | `fal-ai/kling-video/v3/turbo/standard/image-to-video` |
-
-## 3. 请求参数
-
-### 3.1 `text-to-video`
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `prompt` | string | 可选 | — | 建议 **≤ 2500 字符**。**与 `multi_prompt` 互斥** |
-| `multi_prompt` | array | 可选 | — | 多镜头故事板（**1–6 个镜头**），每个镜头有自己的 prompt 与时长，**总时长不得超过 15 s**。**与 `prompt` 互斥** |
-| `aspect_ratio` | string | 可选 | `16:9` | `16:9`、`9:16`、`1:1` |
-| `duration` | string | 可选 | `"5"` | **字符串枚举** `"3"` ~ `"15"` |
-
-### 3.2 `image-to-video`
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `prompt` | string | 可选 | — | 可选文本提示词，建议 ≤ 2500 字符。**与 `multi_prompt` 互斥** |
-| `multi_prompt` | array | 可选 | — | 同上 |
-| `image_url` | string | **必填** | — | 首帧参考图。格式 `.jpg` / `.jpeg` / `.png`；**≤ 50 MB**；单边 **≥ 300 px**；宽高比 `1:2.5` ~ `2.5:1` |
-| `duration` | string | 可选 | `"5"` | `"3"` ~ `"15"` |
-
-> 图生视频端点**没有 `aspect_ratio`**。Turbo 系列**没有 `generate_audio`、`negative_prompt`、`cfg_scale`、`elements`**（`kling-video/v3` 非 Turbo 有）。
-
-## 4. 响应结构
-
-```json
-{ "video": { "url": "https://v3b.fal.media/files/.../output.mp4" } }
-```
-
-## 5. 价格
-
-来源：各端点 `llms.txt`（2026-08-22 读取）。
-
-| 档位 | 单价 |
-|---|---|
-| Turbo Pro | **$0.14 / 秒**（5 秒 = $0.70） |
-| Turbo Standard | **$0.112 / 秒**（5 秒 = $0.56） |
-
-Turbo 没有音频开关，因此没有有声 / 无声的价差。
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。Fal 的 Turbo 端点这两个字段都没有（**与非 Turbo 的 v3 不同，Turbo 没有带默认值的 `negative_prompt`**）。
-- `duration` 是**字符串枚举**。
-- 档位通过 endpoint 路径选择（turbo/pro、turbo/standard），不是参数。
-- **`prompt` 与 `multi_prompt` 互斥**，且多镜头总时长 ≤ 15 s。
-- 图生视频字段是 `image_url`（**单字符串**），与 KIE 的 `image_urls`（数组）、APIMart 的 `first_frame_image` 都不同。
-- Turbo 没有音频，产品上若强调「有声」需引导用户改用 Kling 3.0 或 Omni。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Turbo Pro 文生视频 schema + 价格 | https://fal.ai/models/fal-ai/kling-video/v3/turbo/pro/text-to-video/llms.txt | 否 |
-| Turbo Pro 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/kling-video/v3/turbo/pro/image-to-video/llms.txt | 否 |
-| Turbo Standard 文生视频 schema + 价格 | https://fal.ai/models/fal-ai/kling-video/v3/turbo/standard/text-to-video/llms.txt | 否 |
-| Turbo Standard 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/kling-video/v3/turbo/standard/image-to-video/llms.txt | 否 |
-| 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
-| API Key 创建 | https://fal.ai/dashboard/keys | **是** |
+# Kling 3.0 Turbo · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 视频 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `fal-ai/kling-video/v3/turbo/{pro,standard}/{text-to-video,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. 能力清单
+
+| 档位 | 文生视频 | 图生视频 |
+|---|---|---|
+| Turbo Pro（1080P） | `fal-ai/kling-video/v3/turbo/pro/text-to-video` | `fal-ai/kling-video/v3/turbo/pro/image-to-video` |
+| Turbo Standard（720P） | `fal-ai/kling-video/v3/turbo/standard/text-to-video` | `fal-ai/kling-video/v3/turbo/standard/image-to-video` |
+
+## 3. 请求参数
+
+### 3.1 `text-to-video`
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `prompt` | string | 可选 | — | 建议 **≤ 2500 字符**。**与 `multi_prompt` 互斥** |
+| `multi_prompt` | array | 可选 | — | 多镜头故事板（**1–6 个镜头**），每个镜头有自己的 prompt 与时长，**总时长不得超过 15 s**。**与 `prompt` 互斥** |
+| `aspect_ratio` | string | 可选 | `16:9` | `16:9`、`9:16`、`1:1` |
+| `duration` | string | 可选 | `"5"` | **字符串枚举** `"3"` ~ `"15"` |
+
+### 3.2 `image-to-video`
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `prompt` | string | 可选 | — | 可选文本提示词，建议 ≤ 2500 字符。**与 `multi_prompt` 互斥** |
+| `multi_prompt` | array | 可选 | — | 同上 |
+| `image_url` | string | **必填** | — | 首帧参考图。格式 `.jpg` / `.jpeg` / `.png`；**≤ 50 MB**；单边 **≥ 300 px**；宽高比 `1:2.5` ~ `2.5:1` |
+| `duration` | string | 可选 | `"5"` | `"3"` ~ `"15"` |
+
+> 图生视频端点**没有 `aspect_ratio`**。Turbo 系列**没有 `generate_audio`、`negative_prompt`、`cfg_scale`、`elements`**（`kling-video/v3` 非 Turbo 有）。
+
+## 4. 响应结构
+
+```json
+{ "video": { "url": "https://v3b.fal.media/files/.../output.mp4" } }
+```
+
+## 5. 价格
+
+来源：各端点 `llms.txt`（2026-08-22 读取）。
+
+| 档位 | 单价 |
+|---|---|
+| Turbo Pro | **$0.14 / 秒**（5 秒 = $0.70） |
+| Turbo Standard | **$0.112 / 秒**（5 秒 = $0.56） |
+
+Turbo 没有音频开关，因此没有有声 / 无声的价差。
+
+## 6. 适配要点
+
+- 素材尺寸前置校验（2026-11-08）：`imageConstraints` 首帧宽高 ≥ 300 px、宽高比 0.4–2.5。提交前读取素材实际宽高，不合格直接提示，不发付费请求。
+- 本项目默认**绝对不显示**：`seed`、负面提示词。Fal 的 Turbo 端点这两个字段都没有（**与非 Turbo 的 v3 不同，Turbo 没有带默认值的 `negative_prompt`**）。
+- `duration` 是**字符串枚举**。
+- 档位通过 endpoint 路径选择（turbo/pro、turbo/standard），不是参数。
+- **`prompt` 与 `multi_prompt` 互斥**，且多镜头总时长 ≤ 15 s。
+- 图生视频字段是 `image_url`（**单字符串**），与 KIE 的 `image_urls`（数组）、APIMart 的 `first_frame_image` 都不同。
+- Turbo 没有音频，产品上若强调「有声」需引导用户改用 Kling 3.0 或 Omni。
+
+- 界面与请求一致（2026-11-08“所选即所发”离线检查）：带首帧时图生视频端点没有比例字段，比例参数在带图时隐藏。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Turbo Pro 文生视频 schema + 价格 | https://fal.ai/models/fal-ai/kling-video/v3/turbo/pro/text-to-video/llms.txt | 否 |
+| Turbo Pro 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/kling-video/v3/turbo/pro/image-to-video/llms.txt | 否 |
+| Turbo Standard 文生视频 schema + 价格 | https://fal.ai/models/fal-ai/kling-video/v3/turbo/standard/text-to-video/llms.txt | 否 |
+| Turbo Standard 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/kling-video/v3/turbo/standard/image-to-video/llms.txt | 否 |
+| 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
+| API Key 创建 | https://fal.ai/dashboard/keys | **是** |

package/docs/model-adaptation/Kling-3.0-Turbo/Kling-3.0-Turbo_KIE.md

@@ -1,84 +1,84 @@
-# Kling 3.0 Turbo · KIE
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 视频 |
-| 供应商 | KIE.ai（聚合平台） |
-| 平台模型 ID | `kling/v3-turbo-text-to-video`、`kling/v3-turbo-image-to-video` |
-| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-## 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: ["https://....mp4"] }`
-
-## 2. 能力清单
-
-| 能力 | model |
-|---|---|
-| 文生视频 | `kling/v3-turbo-text-to-video` |
-| 图生视频 | `kling/v3-turbo-image-to-video` |
-
-## 3. 请求参数
-
-### 3.1 `kling/v3-turbo-text-to-video`
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `input.prompt` | string | 必填 | — | 最长 **2500 字符** |
-| `input.duration` | string | **必填** | `"5"` | **字符串**，可选 3 s – 15 s |
-| `input.aspect_ratio` | string | **必填** | `16:9` | `1:1`、`9:16`、`16:9` |
-| `input.resolution` | string | **必填** | `720p` | `720p` / `1080p` |
-
-### 3.2 `kling/v3-turbo-image-to-video`
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `input.prompt` | string | 必填 | — | 最长 2500 字符 |
-| `input.image_urls` | array | **必填** | — | 用于生成视频的图像 URL（传上传后的文件 URL）。支持 `image/jpeg`、`image/png`；**单张 ≤ 10 MB** |
-| `input.duration` | string | **必填** | `"5"` | 3 s – 15 s |
-| `input.resolution` | string | **必填** | `720p` | `720p` / `1080p` |
-
-> 图生视频端点**没有 `aspect_ratio`**（比例由输入图决定），与 APIMart 行为一致。
-
-## 4. 响应结构
-
-`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://....mp4"] }`。
-
-## 5. 价格
-
-来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `kling 3`；1 Credit = $0.005）。
-
-| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
-|---|---|---|---|---|
-| 文生视频 720P | 18 /秒 | **$0.09/秒** | $0.112 | 19.6% |
-| 文生视频 1080P | 22.5 /秒 | **$0.1125/秒** | $0.14 | 19.6% |
-| 图生视频 720P | 18 /秒 | **$0.09/秒** | $0.112 | 19.6% |
-| 图生视频 1080P | 22.5 /秒 | **$0.1125/秒** | $0.14 | 19.6% |
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本组接口都没有这两个字段。
-- **`duration` 是字符串**（`"5"`），APIMart 是整数。
-- 图片字段是 `image_urls`（**数组**），而 APIMart 是 `first_frame_image`（**单字符串**）——同一模型两家写法完全不同。
-- **KIE 的图片单张上限只有 10 MB**，APIMart 侧上游限制是 50 MB。
-- 文生 / 图生是两个 model，需要路由。
-- 没有音频开关、没有分镜结构化字段、没有 4K。
-- `resultJson` 是 JSON 字符串，必须二次 parse。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Kling V3 Turbo 文生视频 | https://docs.kie.ai/cn/market/kling/v3-turbo-text-to-video | 否 |
-| Kling V3 Turbo 图生视频 | https://docs.kie.ai/cn/market/kling/v3-turbo-image-to-video | 否 |
-| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
-| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
-| 定价页（搜 `kling 3`） | https://kie.ai/pricing | 否 |
-| API Key 管理 | https://kie.ai/api-key | **是** |
+# Kling 3.0 Turbo · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-22 |
+| 模态 | 视频 |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID | `kling/v3-turbo-text-to-video`、`kling/v3-turbo-image-to-video` |
+| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 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: ["https://....mp4"] }`
+
+## 2. 能力清单
+
+| 能力 | model |
+|---|---|
+| 文生视频 | `kling/v3-turbo-text-to-video` |
+| 图生视频 | `kling/v3-turbo-image-to-video` |
+
+## 3. 请求参数
+
+### 3.1 `kling/v3-turbo-text-to-video`
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | 必填 | — | 最长 **2500 字符** |
+| `input.duration` | string | **必填** | `"5"` | **字符串**，可选 3 s – 15 s |
+| `input.aspect_ratio` | string | **必填** | `16:9` | `1:1`、`9:16`、`16:9` |
+| `input.resolution` | string | **必填** | `720p` | `720p` / `1080p` |
+
+### 3.2 `kling/v3-turbo-image-to-video`
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | 必填 | — | 最长 2500 字符 |
+| `input.image_urls` | array | **必填** | — | 用于生成视频的图像 URL（传上传后的文件 URL）。支持 `image/jpeg`、`image/png`；**单张 ≤ 10 MB** |
+| `input.duration` | string | **必填** | `"5"` | 3 s – 15 s |
+| `input.resolution` | string | **必填** | `720p` | `720p` / `1080p` |
+
+> 图生视频端点**没有 `aspect_ratio`**（比例由输入图决定），与 APIMart 行为一致。
+
+## 4. 响应结构
+
+`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://....mp4"] }`。
+
+## 5. 价格
+
+来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `kling 3`；1 Credit = $0.005）。
+
+| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
+|---|---|---|---|---|
+| 文生视频 720P | 18 /秒 | **$0.09/秒** | $0.112 | 19.6% |
+| 文生视频 1080P | 22.5 /秒 | **$0.1125/秒** | $0.14 | 19.6% |
+| 图生视频 720P | 18 /秒 | **$0.09/秒** | $0.112 | 19.6% |
+| 图生视频 1080P | 22.5 /秒 | **$0.1125/秒** | $0.14 | 19.6% |
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本组接口都没有这两个字段。
+- **`duration` 是字符串**（`"5"`），APIMart 是整数。
+- 图片字段是 `image_urls`（**数组**），而 APIMart 是 `first_frame_image`（**单字符串**）——同一模型两家写法完全不同。
+- **KIE 的图片单张上限只有 10 MB**，APIMart 侧上游限制是 50 MB。
+- 文生 / 图生是两个 model，需要路由。
+- 没有音频开关、没有分镜结构化字段、没有 4K。
+- `resultJson` 是 JSON 字符串，必须二次 parse。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Kling V3 Turbo 文生视频 | https://docs.kie.ai/cn/market/kling/v3-turbo-text-to-video | 否 |
+| Kling V3 Turbo 图生视频 | https://docs.kie.ai/cn/market/kling/v3-turbo-image-to-video | 否 |
+| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| 定价页（搜 `kling 3`） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |

package/docs/model-adaptation/Kling-4.0/Kling-4.0_APIMart.md

@@ -0,0 +1,76 @@
+# Kling 4.0 · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 模态 | 视频 |
+| 供应商 | APIMart（聚合平台） |
+| 项目模型 ID | `apimart-kling-4.0`（通用标识 `kling-video-4.0`） |
+| 平台模型 ID | `kling-v4`（模型页标题“Kling 4.0 API（可灵 4.0，模型 ID：kling-v4）”） |
+| 接口形态 | 异步任务 |
+| 文档 / 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- 提交：`POST /v1/videos/generations` → `data[0].task_id`
+- 查询：`GET /v1/tasks/{task_id}`（文档也给出 `GET /v1/videos/generations/{task_id}`），完成后读 `data.result.videos[0].url[0]`，结果保留 72 小时
+- 生成耗时参考：3 秒 720p 约 3 分钟，15 秒约 3.5 分钟
+
+## 2. 能力（同一模型名，按素材与 `omni_reference_task_type` 自动路由）
+
+| 模式 | 传参 |
+|---|---|
+| 文生视频 | 不传素材 |
+| 图生视频 | `image_urls` 第 1 张首帧、第 2 张尾帧；`image_with_roles` 还可加最多 8 张 `keyframe`，首尾中间帧合计 ≤ 10 |
+| 参考生视频 | `image_urls`（≤ 10）/ `video_urls`（≤ 5，合计用 30 秒）/ `audio_urls`（≤ 3，每段 5–30 秒），三类合计 ≤ 15；`omni_reference_task_type: "reference"` |
+| 视频编辑 | `omni_reference_task_type: "edit"` + `video_url`（≥ 3 秒，超过 30 秒截前 30 秒），可加参考图 ≤ 10 |
+| 视频续写 | `omni_reference_task_type: "extend"` + `video_url`，`duration` 为新增时长，可用 `last_frame_image` 指定目标尾帧 |
+
+始终生成带立体声的视频；V4 没有 `mode`（std/pro/4k）。
+
+## 3. 请求参数
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `model` | `kling-v4` | 必填 |
+| `prompt` | string | 图生视频可省略，其余必填；参考模式可用 `@Image1` `@Video1` `@Audio1` |
+| `duration` | 3–30 | 默认 5；编辑不传时跟随输入视频；续写表示新增时长 |
+| `resolution` | `720p` / `1080p` | 默认 `720p` |
+| `aspect_ratio` | `16:9` / `9:16` / `1:1` / `21:9`，参考模式另有 `auto` | 文生默认 16:9，图生跟随首帧，编辑跟随输入视频，续写不支持 |
+| `image_urls` / `image_with_roles` / `first_frame_image` / `last_frame_image` | 见第 2 节 | 公网 URL |
+| `video_urls` / `video_url` | 见第 2 节 | 只传 `video_url` 不指定 edit/extend 返回 400 |
+| `audio_urls` | ≤ 3 段 | 仅参考模式 |
+| `omni_reference_task_type` | `auto` / `reference` / `edit` / `extend` | |
+| `audio_setting` | `origin` / `auto` | 编辑默认保留原声；带参考视频的参考生视频默认重新生成；续写不支持 |
+| 报 400 | `mode`、`negative_prompt`、`watermark: true`、`audio: false`、`multi_shot`、`multi_prompt`、`element_list`、`video_list`、`camera_control`、`voice_list` | |
+
+## 4. 价格
+
+来源：[Kling 4.0 模型页](https://apimart.ai/zh/model/kling-4-0)（2026-11-07 读取，黄金价 = 当前价）；定价中心起步价 `kling-v4 $0.084/秒` 与模型页的视频输入档一致。
+
+| 规格 | 单价 |
+|---|---|
+| 720P 生成 | $0.14 / 秒 |
+| 1080P 生成 | $0.21 / 秒 |
+| 720P 视频输入（720P-input） | $0.084 / 秒 |
+| 1080P 视频输入（1080P-input） | $0.126 / 秒 |
+
+计费秒数（API 文档）：文生、图生、仅图片或音频的参考生视频按输出秒数；续写按新增秒数；视频编辑与带参考视频的参考生视频按视频输入单价，计 `输出秒数 + max(输出秒数, 输入视频秒数)`，输入秒数各段相加向上取整，最多 30 秒（例：3.04 秒视频编辑不传时长，输出 4 秒，计 8 秒）。模型页 5 秒 720p 文生示例 “run ≈ 7 Credits” 与 $0.14/秒吻合。
+
+## 5. 项目适配
+
+- 显式 `role: 'mode'` 模式：文/图生视频（0 张文生，1 张首帧，2 张首尾帧）、参考生视频、视频编辑、视频续写。
+- 比例默认“智能”：文生发 16:9，图生不发（跟随首帧），参考模式发 `auto`，编辑不发（跟随输入视频）；续写隐藏比例。
+- 时长 3–30，编辑模式隐藏且不发送（输出跟随输入视频，按输入秒数 ×2 估价）。
+- 编辑模式提供“保留视频原声”开关（默认开 → `origin`，关 → `auto`）。
+- 未接入：中间帧 `keyframe`（需要专门的多帧排序入口）、续写目标尾帧之外的 `image_with_roles` 写法。
+- 不支持分镜与元素：API 文档「不支持的参数」一节列明 `multi_shot`、`multi_prompt`、`element_list`、`video_list` 返回 HTTP 400（2026-11-07 复核），所以 APIMart 版没有“分镜”“元素”参数；要用这两项请选 Fal（分镜仅标准版）或 KIE（仅元素）。
+- APIMart 没有通用视频 / 音频上传端点，视频与音频素材必须是公网 URL（见供应商文档第 4 节）。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| API 文档 | https://docs.apimart.ai/cn/api-reference/videos/kling-v4/generation | 否 |
+| 模型页（价格） | https://apimart.ai/zh/model/kling-4-0 | 否 |
+| 定价中心（起步价） | https://apimart.ai/zh/pricing | 否 |