@henjicc/ai-sdk 0.2.8 → 0.4.0

package/docs/model-adaptation/Kling-3.0-Omni/Kling-3.0-Omni_KIE.md

@@ -1,143 +1,143 @@
-# Kling 3.0 Omni · KIE
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 视频 |
-| 供应商 | KIE.ai（聚合平台） |
-| 平台模型 ID | `kling-3.0-omni/text-to-video`、`kling-3.0-omni/image-to-video`、`kling-3.0-omni/reference-to-video`、`kling-3.0-omni/transformation` |
-| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录（**定价页未单列 Omni 条目，见第 5 节**） |
-
-> KIE 上 Kling 3.0 Omni 有 **4 个端点**，其中 `transformation`（视频转换 / 编辑）是上一版适配遗漏的能力。
-
-## 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-3.0-omni/text-to-video` |
-| 图生视频（单张首帧） | `kling-3.0-omni/image-to-video` |
-| 参考生视频（参考图 / 参考视频 / 主体） | `kling-3.0-omni/reference-to-video` |
-| **视频转换 / 编辑** | `kling-3.0-omni/transformation` |
-
-## 3. 请求参数
-
-### 3.1 通用字段（四个端点共有或大部分共有）
-
-| 字段 | 类型 | 默认 | 取值与说明 |
-|---|---|---|---|
-| `input.prompt` | string | — | 去首尾空白后不能为空，**最长 3072 字符** |
-| `input.duration` | integer | `5` | 枚举 3–15 秒 |
-| `input.resolution` | string | `720p` | `720p` / `1080p` / **`4k`** |
-| `input.aspect_ratio` | string | 视端点而定 | `16:9`、`9:16`、`1:1`、`auto`（各端点可选集合不同，见下） |
-| `input.audio` | boolean | `false` | 是否开启音频。**建议显式传入** |
-| `input.customize_multi_shots` | boolean | 文生 `true` | 是否开启**自定义**多镜头。**建议显式指定** |
-| `input.prefer_multi_shots` | boolean | — | 是否开启**智能分镜**。**与 `customize_multi_shots` 互斥**：两者可以同时为 `false`，但**不能同时为 `true`** |
-| `input.multi_prompt` | array | `[]` | 自定义分镜列表，**最多 6 个**。`customize_multi_shots=true` 时必填且不能为空；为 `false` 时**必须为空数组或省略** |
-| `input.elements` | array | `[]` | 一次性主体素材列表，见下 |
-
-`multi_prompt` 元素：`prompt`（1–512 字符，必填）、`duration`（**1–15 秒**，必填）。
-
-### 3.2 `elements`（主体素材）
-
-| 字段 | 类型 | 必填 | 说明 |
-|---|---|---|---|
-| `name` | string | 必填 | 主体名称，**同一请求内唯一**，prompt 中用 `@名称` 引用 |
-| `description` | string | 必填 | 主体素材的文本描述 |
-| `element_input_urls` | array | 必填 | **多图主体传 2–4 张图片；视频角色主体恰好传 1 个视频；图片和视频不能混传**。支持 HTTP / HTTPS / OSS |
-| `element_input_audio_urls` | array | 可选 | 主体音频素材。可读到时长时**必须为 5–30 秒** |
-| `start_time` | integer | 可选（默认 `0`） | 视频角色主体截取开始时间（毫秒），仅传视频时生效 |
-| `end_time` | integer | 可选（默认 `8000`） | 截取结束时间（毫秒），须大于 `start_time`，**截取时长必须为 3000–8000 ms** |
-
-**主体数量限制（文生 / 参考端点）**：仅多图主体时最多 **7 个**主体；仅视频角色主体时不超过 **3 个**；两者同时存在时视频角色主体 ≤ 3、多图主体 ≤ 4。
-**图生视频端点**的 `elements` 上限是 **3 个**。
-
-### 3.3 `kling-3.0-omni/text-to-video`
-
-`aspect_ratio` 可选 `16:9`（默认）、`9:16`、`1:1`。`customize_multi_shots` **默认 `true`**。
-
-### 3.4 `kling-3.0-omni/image-to-video`（`input` 为 `oneOf`，此处为「单张首帧」形态）
-
-| 字段 | 必填 | 说明 |
-|---|---|---|
-| `prompt` | **必填** | ≤ 3072 字符 |
-| `image_urls` | **必填** | 首帧图片，**必须且只能传 1 张**。HTTP / HTTPS / OSS；JPG / JPEG / PNG；**≤ 50 MB**；宽高均 ≥ 300 px；宽高比 0.4–2.5 |
-| `aspect_ratio` | 可选，默认 **`auto`** | `16:9` / `9:16` / `1:1` / `auto`。**只有开启 `customize_multi_shots` 时才可以选 16:9 / 9:16 / 1:1，其余情况为 `auto`** |
-
-### 3.5 `kling-3.0-omni/reference-to-video`（`input` 为 `oneOf`）
-
-**形态 A「无视频输入」**（必填 `prompt` + `image_urls`）
-
-| 字段 | 说明 |
-|---|---|
-| `image_urls` | 参考图片数组，**最多 7 张**。图片数量上限与主体数量/类型相关：无参考视频 + 仅多图主体时，**参考图片与多图主体数量之和 ≤ 7**；无参考视频 + 同时有视频角色主体和多图主体时，**参考图片与多图主体数量之和 ≤ 4**。JPG / JPEG / PNG；≤ 50 MB；宽高 ≥ 300 px；宽高比 0.4–2.5 |
-| `aspect_ratio` | `16:9`（默认）/ `9:16` / `1:1` |
-| `audio` | 无视频输入时支持 `true` / `false` |
-
-**形态 B「仅视频输入」**（必填 `prompt`、`video_urls`、`aspect_ratio`、`audio`）
-
-| 字段 | 说明 |
-|---|---|
-| `video_urls` | **必须且只能传 1 个视频**。MP4 / MOV；**≤ 200 MB**；时长 **3–15.5 秒**；宽高 **700–4553 px**；总像素 **≤ 8,294,400**；宽高比 **0.4–2**；帧率 **24–60 fps** |
-
-### 3.6 `kling-3.0-omni/transformation`（视频转换 / 编辑）
-
-| 字段 | 类型 | 必填 | 默认 | 说明 |
-|---|---|---|---|---|
-| `prompt` | string | 可选 | — | ≤ 3072 字符 |
-| `video_urls` | array | 可选 | — | **必须且只能 1 个视频**。规格同上（MP4/MOV、≤200 MB、3–15.5 s、700–4553 px、总像素 ≤ 8,294,400、宽高比 0.4–2、24–60 fps） |
-| `image_urls` | array | 可选 | — | **最多 4 张**。上限与主体数量/类型有关：仅有多图主体时**参考图片与多图主体数量之和 ≤ 4**；**不同时支持视频角色主体与多图主体或参考图片**。JPG / JPEG / PNG；≤ 50 MB；宽高 ≥ 300 px；宽高比 0.4–2.5 |
-| `duration` | string | 可选 | — | **视频加图片时可保留该字段配置**（纯视频输入时时长跟随源视频） |
-| `resolution` | string | 可选 | `720p` | `720p` / `1080p` / `4k` |
-| `aspect_ratio` | string | 可选 | `16:9` | **仅视频输入时只能为 `auto`；视频加图片时支持 `16:9` / `9:16` / `1:1`，不支持 `auto`** |
-| `audio` | boolean | 可选 | — | 是否开启音频 |
-| `elements` | array | 可选 | `[]` | 同上 |
-
-## 4. 响应结构
-
-`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://....mp4"] }`。
-
-## 5. 价格
-
-⚠️ **KIE 定价页（2026-08-22 读取，搜索 `kling` / `omni`）未单独列出 `kling-3.0-omni` 的价格条目**，只有 `Kling 3.0`、`kling 3.0 turbo`、`kling 3.0 motion control` 三组。
-
-接入前需要向 KIE 确认 Omni 的计费口径，或先跑一次任务从 `creditsConsumed` 反推。可作为参考的同代价格（`Kling 3.0`，1 Credit = $0.005）：
-
-| 规格 | 积分 | 我们的价格 |
-|---|---|---|
-| 720P 无声 / 有声 | 14 / 20 每秒 | $0.07 / $0.1 每秒 |
-| 1080P 无声 / 有声 | 18 / 27 每秒 | $0.09 / $0.135 每秒 |
-| 4K 无声 / 有声 | 67 / 67 每秒 | $0.335 / $0.335 每秒 |
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本组接口都没有这两个字段。
-- **4 个端点的 `aspect_ratio` 规则各不相同**，尤其 `image-to-video`「只有开启自定义多镜头才能选具体比例」和 `transformation`「纯视频输入只能 `auto`、视频+图片不支持 `auto`」——UI 必须按端点与输入组合联动。
-- `customize_multi_shots` 与 `prefer_multi_shots` **不能同时为 `true`**。
-- `customize_multi_shots=false` 时 `multi_prompt` **必须是空数组或不传**，传了会报错。
-- `elements` 的主体数量上限是**动态的**（取决于是否有参考视频、主体类型），需要在前端做组合校验。
-- 视频角色主体的截取窗口必须是 3000–8000 ms。
-- **Omni 在 KIE 定价页没有独立条目**，成本核算需先实测。
-- `resultJson` 是 JSON 字符串，必须二次 parse。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Kling 3.0 Omni 文生视频 | https://docs.kie.ai/cn/market/kling/v3-omni-text-to-video | 否 |
-| Kling 3.0 Omni 图生视频 | https://docs.kie.ai/cn/market/kling/v3-omni-image-to-video | 否 |
-| Kling 3.0 Omni Reference-To-Video | https://docs.kie.ai/cn/market/kling/v3-omni-reference-to-video | 否 |
-| Kling 3.0 Omni Transformation | https://docs.kie.ai/cn/market/kling/v3-omni-transformation | 否 |
-| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
-| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
-| 定价页（搜 `kling`；**Omni 无独立条目**） | https://kie.ai/pricing | 否 |
-| API Key 管理 | https://kie.ai/api-key | **是** |
+# Kling 3.0 Omni · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-22 |
+| 模态 | 视频 |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID | `kling-3.0-omni/text-to-video`、`kling-3.0-omni/image-to-video`、`kling-3.0-omni/reference-to-video`、`kling-3.0-omni/transformation` |
+| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录（**定价页未单列 Omni 条目，见第 5 节**） |
+
+> KIE 上 Kling 3.0 Omni 有 **4 个端点**，其中 `transformation`（视频转换 / 编辑）是上一版适配遗漏的能力。
+
+## 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-3.0-omni/text-to-video` |
+| 图生视频（单张首帧） | `kling-3.0-omni/image-to-video` |
+| 参考生视频（参考图 / 参考视频 / 主体） | `kling-3.0-omni/reference-to-video` |
+| **视频转换 / 编辑** | `kling-3.0-omni/transformation` |
+
+## 3. 请求参数
+
+### 3.1 通用字段（四个端点共有或大部分共有）
+
+| 字段 | 类型 | 默认 | 取值与说明 |
+|---|---|---|---|
+| `input.prompt` | string | — | 去首尾空白后不能为空，**最长 3072 字符** |
+| `input.duration` | integer | `5` | 枚举 3–15 秒 |
+| `input.resolution` | string | `720p` | `720p` / `1080p` / **`4k`** |
+| `input.aspect_ratio` | string | 视端点而定 | `16:9`、`9:16`、`1:1`、`auto`（各端点可选集合不同，见下） |
+| `input.audio` | boolean | `false` | 是否开启音频。**建议显式传入** |
+| `input.customize_multi_shots` | boolean | 文生 `true` | 是否开启**自定义**多镜头。**建议显式指定** |
+| `input.prefer_multi_shots` | boolean | — | 是否开启**智能分镜**。**与 `customize_multi_shots` 互斥**：两者可以同时为 `false`，但**不能同时为 `true`** |
+| `input.multi_prompt` | array | `[]` | 自定义分镜列表，**最多 6 个**。`customize_multi_shots=true` 时必填且不能为空；为 `false` 时**必须为空数组或省略** |
+| `input.elements` | array | `[]` | 一次性主体素材列表，见下 |
+
+`multi_prompt` 元素：`prompt`（1–512 字符，必填）、`duration`（**1–15 秒**，必填）。
+
+### 3.2 `elements`（主体素材）
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `name` | string | 必填 | 主体名称，**同一请求内唯一**，prompt 中用 `@名称` 引用 |
+| `description` | string | 必填 | 主体素材的文本描述 |
+| `element_input_urls` | array | 必填 | **多图主体传 2–4 张图片；视频角色主体恰好传 1 个视频；图片和视频不能混传**。支持 HTTP / HTTPS / OSS |
+| `element_input_audio_urls` | array | 可选 | 主体音频素材。可读到时长时**必须为 5–30 秒** |
+| `start_time` | integer | 可选（默认 `0`） | 视频角色主体截取开始时间（毫秒），仅传视频时生效 |
+| `end_time` | integer | 可选（默认 `8000`） | 截取结束时间（毫秒），须大于 `start_time`，**截取时长必须为 3000–8000 ms** |
+
+**主体数量限制（文生 / 参考端点）**：仅多图主体时最多 **7 个**主体；仅视频角色主体时不超过 **3 个**；两者同时存在时视频角色主体 ≤ 3、多图主体 ≤ 4。
+**图生视频端点**的 `elements` 上限是 **3 个**。
+
+### 3.3 `kling-3.0-omni/text-to-video`
+
+`aspect_ratio` 可选 `16:9`（默认）、`9:16`、`1:1`。`customize_multi_shots` **默认 `true`**。
+
+### 3.4 `kling-3.0-omni/image-to-video`（`input` 为 `oneOf`，此处为「单张首帧」形态）
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| `prompt` | **必填** | ≤ 3072 字符 |
+| `image_urls` | **必填** | 首帧图片，**必须且只能传 1 张**。HTTP / HTTPS / OSS；JPG / JPEG / PNG；**≤ 50 MB**；宽高均 ≥ 300 px；宽高比 0.4–2.5 |
+| `aspect_ratio` | 可选，默认 **`auto`** | `16:9` / `9:16` / `1:1` / `auto`。**只有开启 `customize_multi_shots` 时才可以选 16:9 / 9:16 / 1:1，其余情况为 `auto`** |
+
+### 3.5 `kling-3.0-omni/reference-to-video`（`input` 为 `oneOf`）
+
+**形态 A「无视频输入」**（必填 `prompt` + `image_urls`）
+
+| 字段 | 说明 |
+|---|---|
+| `image_urls` | 参考图片数组，**最多 7 张**。图片数量上限与主体数量/类型相关：无参考视频 + 仅多图主体时，**参考图片与多图主体数量之和 ≤ 7**；无参考视频 + 同时有视频角色主体和多图主体时，**参考图片与多图主体数量之和 ≤ 4**。JPG / JPEG / PNG；≤ 50 MB；宽高 ≥ 300 px；宽高比 0.4–2.5 |
+| `aspect_ratio` | `16:9`（默认）/ `9:16` / `1:1` |
+| `audio` | 无视频输入时支持 `true` / `false` |
+
+**形态 B「仅视频输入」**（必填 `prompt`、`video_urls`、`aspect_ratio`、`audio`）
+
+| 字段 | 说明 |
+|---|---|
+| `video_urls` | **必须且只能传 1 个视频**。MP4 / MOV；**≤ 200 MB**；时长 **3–15.5 秒**；宽高 **700–4553 px**；总像素 **≤ 8,294,400**；宽高比 **0.4–2**；帧率 **24–60 fps** |
+
+### 3.6 `kling-3.0-omni/transformation`（视频转换 / 编辑）
+
+| 字段 | 类型 | 必填 | 默认 | 说明 |
+|---|---|---|---|---|
+| `prompt` | string | 可选 | — | ≤ 3072 字符 |
+| `video_urls` | array | 可选 | — | **必须且只能 1 个视频**。规格同上（MP4/MOV、≤200 MB、3–15.5 s、700–4553 px、总像素 ≤ 8,294,400、宽高比 0.4–2、24–60 fps） |
+| `image_urls` | array | 可选 | — | **最多 4 张**。上限与主体数量/类型有关：仅有多图主体时**参考图片与多图主体数量之和 ≤ 4**；**不同时支持视频角色主体与多图主体或参考图片**。JPG / JPEG / PNG；≤ 50 MB；宽高 ≥ 300 px；宽高比 0.4–2.5 |
+| `duration` | string | 可选 | — | **视频加图片时可保留该字段配置**（纯视频输入时时长跟随源视频） |
+| `resolution` | string | 可选 | `720p` | `720p` / `1080p` / `4k` |
+| `aspect_ratio` | string | 可选 | `16:9` | **仅视频输入时只能为 `auto`；视频加图片时支持 `16:9` / `9:16` / `1:1`，不支持 `auto`** |
+| `audio` | boolean | 可选 | — | 是否开启音频 |
+| `elements` | array | 可选 | `[]` | 同上 |
+
+## 4. 响应结构
+
+`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://....mp4"] }`。
+
+## 5. 价格
+
+⚠️ **KIE 定价页（2026-08-22 读取，搜索 `kling` / `omni`）未单独列出 `kling-3.0-omni` 的价格条目**，只有 `Kling 3.0`、`kling 3.0 turbo`、`kling 3.0 motion control` 三组。
+
+接入前需要向 KIE 确认 Omni 的计费口径，或先跑一次任务从 `creditsConsumed` 反推。可作为参考的同代价格（`Kling 3.0`，1 Credit = $0.005）：
+
+| 规格 | 积分 | 我们的价格 |
+|---|---|---|
+| 720P 无声 / 有声 | 14 / 20 每秒 | $0.07 / $0.1 每秒 |
+| 1080P 无声 / 有声 | 18 / 27 每秒 | $0.09 / $0.135 每秒 |
+| 4K 无声 / 有声 | 67 / 67 每秒 | $0.335 / $0.335 每秒 |
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本组接口都没有这两个字段。
+- **4 个端点的 `aspect_ratio` 规则各不相同**，尤其 `image-to-video`「只有开启自定义多镜头才能选具体比例」和 `transformation`「纯视频输入只能 `auto`、视频+图片不支持 `auto`」——UI 必须按端点与输入组合联动。
+- `customize_multi_shots` 与 `prefer_multi_shots` **不能同时为 `true`**。
+- `customize_multi_shots=false` 时 `multi_prompt` **必须是空数组或不传**，传了会报错。
+- `elements` 的主体数量上限是**动态的**（取决于是否有参考视频、主体类型），需要在前端做组合校验。
+- 视频角色主体的截取窗口必须是 3000–8000 ms。
+- **Omni 在 KIE 定价页没有独立条目**，成本核算需先实测。
+- `resultJson` 是 JSON 字符串，必须二次 parse。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Kling 3.0 Omni 文生视频 | https://docs.kie.ai/cn/market/kling/v3-omni-text-to-video | 否 |
+| Kling 3.0 Omni 图生视频 | https://docs.kie.ai/cn/market/kling/v3-omni-image-to-video | 否 |
+| Kling 3.0 Omni Reference-To-Video | https://docs.kie.ai/cn/market/kling/v3-omni-reference-to-video | 否 |
+| Kling 3.0 Omni Transformation | https://docs.kie.ai/cn/market/kling/v3-omni-transformation | 否 |
+| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| 定价页（搜 `kling`；**Omni 无独立条目**） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |

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

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

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

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