@henjicc/ai-sdk 0.2.8 → 0.3.0

package/docs/model-adaptation/Seedance-2.5/Seedance-2.5_KIE.md

@@ -1,89 +1,89 @@
-# Seedance 2.5 · KIE
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 视频 |
-| 供应商 | KIE.ai（聚合平台） |
-| 平台模型 ID | `bytedance/seedance-2-5` |
-| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-## 1. 接入协议
-
-- **Base URL**：`https://api.kie.ai`
-- **鉴权**：`Authorization: Bearer <API_KEY>`
-- **提交**：`POST /api/v1/jobs/createTask`，体为 `{ model: "bytedance/seedance-2-5", callBackUrl?, input }`
-- **查询**：`GET /api/v1/jobs/recordInfo?taskId=...`
-- **终态**：`state` ∈ `waiting` / `queuing` / `generating` / `success` / `fail`
-- **结果**：`JSON.parse(resultJson)` → `{ resultUrls: [...] }`；开启 `return_last_frame` 时为 `{ resultUrls: [], firstFrameUrl: [], lastFrameUrl: [] }`
-
-## 2. 请求参数
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `input.prompt` | string | 可选 | — | 文本提示词，最多 **30000** 字符 |
-| `input.first_frame_url` | string | 可选 | — | 首帧图片地址或 `asset://{assetId}`。**不能与 `reference_image_urls` / `reference_video_urls` / `reference_audio_urls` 同时使用** |
-| `input.last_frame_url` | string | 可选 | — | 尾帧图片地址或 `asset://{assetId}`。**不可单独只传 `last_frame_url`，必须同时传 `first_frame_url`** |
-| `input.reference_image_urls` | array | 可选 | — | 参考图，**最多 30 张**（与首尾帧张数之和不超过 30）。格式 jpeg/png/webp/bmp/tiff/gif；宽高比 (0.4, 2.5)；边长 (300, 6000) px；单张 < 30 MB。**与首尾帧场景互斥** |
-| `input.reference_video_urls` | array | 可选 | — | 参考视频，**最多 10 个**。格式 mp4/mov；分辨率 480p/720p；宽高比 [0.4, 2.5]；边长 [300, 6000] px；总像素 [409600, 927408]；单个 ≤ **200 MB**；帧率 [24, 60]；单个时长 [2, 30] s；**总时长 ≤ 30 s**。**与首尾帧场景互斥** |
-| `input.reference_audio_urls` | array | 可选 | — | 参考音频，**最多 10 段**。格式 wav/mp3；单个 ≤ 15 MB；单段时长 [2, 30] s；总时长 ≤ 30 s。**与首尾帧场景互斥** |
-| `input.return_last_frame` | boolean | 可选 | `false` | 是否返回视频最后一帧图片。**`draft=true` 时不支持传 `true`** |
-| `input.generate_audio` | boolean | 可选 | **`true`** | 是否生成与画面同步的音频 |
-| `input.resolution` | string | 可选 | `720p` | `480p` / `720p` / `1080p`（**无 4k**） |
-| `input.aspect_ratio` | string | 可选 | **`adaptive`** | `1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`21:9`、`adaptive` |
-| `input.duration` | integer | 可选 | `5` | **4–30 秒**。特殊值 **`-1`**：自动选择时长——视频编辑任务下匹配输入视频时长，其他任务类型在有效范围内自主选择 |
-| `input.output_format` | string | 可选 | `mp4` | `mp4` / `mov` |
-| `input.web_search` | string | 可选 | — | 是否开启联网搜索（**schema 类型标注为 string，不是 boolean，接入前实测确认**） |
-| `input.nsfw_checker` | boolean | 可选 | `false` | `false` 时关闭内容过滤 |
-
-> KIE 的 schema 里出现了 `draft` 的说明（`return_last_frame` 描述提到 `draft=true`），但请求体中**没有 `draft` 字段**，接入前需确认。
-
-### 与 APIMart 的差异
-
-- KIE **没有 `omni_reference_task_type`**（APIMart 用它把编辑 / 延长的异步报错提前成同步报错）
-- KIE 没有 `watermark`、没有 `tools`（改为 `web_search` 布尔/字符串开关）
-- KIE 把首尾帧与参考素材做成**硬互斥**（APIMart 是自动降级为 `reference_image`）
-
-## 3. 响应结构
-
-`state=success` 后 `JSON.parse(resultJson)`：
-- 普通：`{ "resultUrls": ["https://....mp4"] }`
-- 开启 `return_last_frame`：`{ "resultUrls": [], "firstFrameUrl": [], "lastFrameUrl": [] }`
-
-## 4. 价格
-
-来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `seedance`；1 Credit = $0.005）。
-
-| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
-|---|---|---|---|---|
-| 480p no video | 28 /秒 | **$0.140/秒** | $0.2205 | 36.5% |
-| 480p with video | 17 /秒 | **$0.085/秒** | $0.1323 | 35.8% |
-| 720p no video | 63 /秒 | **$0.315/秒** | $0.4730 | 33.4% |
-| 720p with video | 38 /秒 | **$0.190/秒** | $0.2838 | 33.0% |
-| 1080p no video | 114 /秒 | **$0.570/秒** | $1.1372 | 49.9% |
-| 1080p with video | 68.5 /秒 | **$0.3425/秒** | $0.6823 | 49.8% |
-
-> 计费规则：**无视频输入时 总价 = 单价 × 输出时长；有视频输入时 总价 = 单价 × (输入 + 输出) 时长**。
-
-## 5. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本接口两个字段都没有。
-- `output_format` 默认不显示、不请求。
-- **首尾帧与参考素材在 KIE 上是硬互斥**，UI 必须二选一，不能像 APIMart 那样自动降级。
-- `last_frame_url` 不能单独传，必须配 `first_frame_url`。
-- `aspect_ratio` 默认 `adaptive`（2.0 系列默认 `16:9`），跨代不能共用默认值。
-- `web_search` 的 schema 类型是 string 而非 boolean，接入前实测。
-- 有视频输入时计费按「输入 + 输出总时长」。
-- `resultJson` 是 JSON 字符串，必须二次 parse；`return_last_frame` 会改变结构。
-
-## 6. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Bytedance Seedance 2.5 | https://docs.kie.ai/cn/market/bytedance/seedance-2-5 | 否 |
-| 获取任务详情（含 return_last_frame 结果结构） | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
-| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
-| 定价页（搜 `seedance`） | https://kie.ai/pricing | 否 |
-| API Key 管理 | https://kie.ai/api-key | **是** |
+# Seedance 2.5 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-22 |
+| 模态 | 视频 |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID | `bytedance/seedance-2-5` |
+| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.kie.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /api/v1/jobs/createTask`，体为 `{ model: "bytedance/seedance-2-5", callBackUrl?, input }`
+- **查询**：`GET /api/v1/jobs/recordInfo?taskId=...`
+- **终态**：`state` ∈ `waiting` / `queuing` / `generating` / `success` / `fail`
+- **结果**：`JSON.parse(resultJson)` → `{ resultUrls: [...] }`；开启 `return_last_frame` 时为 `{ resultUrls: [], firstFrameUrl: [], lastFrameUrl: [] }`
+
+## 2. 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | 可选 | — | 文本提示词，最多 **30000** 字符 |
+| `input.first_frame_url` | string | 可选 | — | 首帧图片地址或 `asset://{assetId}`。**不能与 `reference_image_urls` / `reference_video_urls` / `reference_audio_urls` 同时使用** |
+| `input.last_frame_url` | string | 可选 | — | 尾帧图片地址或 `asset://{assetId}`。**不可单独只传 `last_frame_url`，必须同时传 `first_frame_url`** |
+| `input.reference_image_urls` | array | 可选 | — | 参考图，**最多 30 张**（与首尾帧张数之和不超过 30）。格式 jpeg/png/webp/bmp/tiff/gif；宽高比 (0.4, 2.5)；边长 (300, 6000) px；单张 < 30 MB。**与首尾帧场景互斥** |
+| `input.reference_video_urls` | array | 可选 | — | 参考视频，**最多 10 个**。格式 mp4/mov；分辨率 480p/720p；宽高比 [0.4, 2.5]；边长 [300, 6000] px；总像素 [409600, 927408]；单个 ≤ **200 MB**；帧率 [24, 60]；单个时长 [2, 30] s；**总时长 ≤ 30 s**。**与首尾帧场景互斥** |
+| `input.reference_audio_urls` | array | 可选 | — | 参考音频，**最多 10 段**。格式 wav/mp3；单个 ≤ 15 MB；单段时长 [2, 30] s；总时长 ≤ 30 s。**与首尾帧场景互斥** |
+| `input.return_last_frame` | boolean | 可选 | `false` | 是否返回视频最后一帧图片。**`draft=true` 时不支持传 `true`** |
+| `input.generate_audio` | boolean | 可选 | **`true`** | 是否生成与画面同步的音频 |
+| `input.resolution` | string | 可选 | `720p` | `480p` / `720p` / `1080p`（**无 4k**） |
+| `input.aspect_ratio` | string | 可选 | **`adaptive`** | `1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`21:9`、`adaptive` |
+| `input.duration` | integer | 可选 | `5` | **4–30 秒**。特殊值 **`-1`**：自动选择时长——视频编辑任务下匹配输入视频时长，其他任务类型在有效范围内自主选择 |
+| `input.output_format` | string | 可选 | `mp4` | `mp4` / `mov` |
+| `input.web_search` | string | 可选 | — | 是否开启联网搜索（**schema 类型标注为 string，不是 boolean，接入前实测确认**） |
+| `input.nsfw_checker` | boolean | 可选 | `false` | `false` 时关闭内容过滤 |
+
+> KIE 的 schema 里出现了 `draft` 的说明（`return_last_frame` 描述提到 `draft=true`），但请求体中**没有 `draft` 字段**，接入前需确认。
+
+### 与 APIMart 的差异
+
+- KIE **没有 `omni_reference_task_type`**（APIMart 用它把编辑 / 延长的异步报错提前成同步报错）
+- KIE 没有 `watermark`、没有 `tools`（改为 `web_search` 布尔/字符串开关）
+- KIE 把首尾帧与参考素材做成**硬互斥**（APIMart 是自动降级为 `reference_image`）
+
+## 3. 响应结构
+
+`state=success` 后 `JSON.parse(resultJson)`：
+- 普通：`{ "resultUrls": ["https://....mp4"] }`
+- 开启 `return_last_frame`：`{ "resultUrls": [], "firstFrameUrl": [], "lastFrameUrl": [] }`
+
+## 4. 价格
+
+来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `seedance`；1 Credit = $0.005）。
+
+| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
+|---|---|---|---|---|
+| 480p no video | 28 /秒 | **$0.140/秒** | $0.2205 | 36.5% |
+| 480p with video | 17 /秒 | **$0.085/秒** | $0.1323 | 35.8% |
+| 720p no video | 63 /秒 | **$0.315/秒** | $0.4730 | 33.4% |
+| 720p with video | 38 /秒 | **$0.190/秒** | $0.2838 | 33.0% |
+| 1080p no video | 114 /秒 | **$0.570/秒** | $1.1372 | 49.9% |
+| 1080p with video | 68.5 /秒 | **$0.3425/秒** | $0.6823 | 49.8% |
+
+> 计费规则：**无视频输入时 总价 = 单价 × 输出时长；有视频输入时 总价 = 单价 × (输入 + 输出) 时长**。
+
+## 5. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本接口两个字段都没有。
+- `output_format` 默认不显示、不请求。
+- **首尾帧与参考素材在 KIE 上是硬互斥**，UI 必须二选一，不能像 APIMart 那样自动降级。
+- `last_frame_url` 不能单独传，必须配 `first_frame_url`。
+- `aspect_ratio` 默认 `adaptive`（2.0 系列默认 `16:9`），跨代不能共用默认值。
+- `web_search` 的 schema 类型是 string 而非 boolean，接入前实测。
+- 有视频输入时计费按「输入 + 输出总时长」。
+- `resultJson` 是 JSON 字符串，必须二次 parse；`return_last_frame` 会改变结构。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Bytedance Seedance 2.5 | https://docs.kie.ai/cn/market/bytedance/seedance-2-5 | 否 |
+| 获取任务详情（含 return_last_frame 结果结构） | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| 定价页（搜 `seedance`） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |

package/docs/model-adaptation/Seedream-5.0-Lite/Seedream-5.0-Lite_APIMart.md

@@ -1,106 +1,106 @@
-# Seedream 5.0 Lite · APIMart
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-30 |
-| 模态 | 图片 |
-| 供应商 | APIMart（聚合平台） |
-| 平台模型 ID | `seedream-5-0-lite`（兼容 `seedream-5.0-lite`、`Seedream-5.0-lite`） |
-| 接口形态 | **异步任务** |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-## 1. 接入协议
-
-- **Base URL**：`https://api.apimart.ai`
-- **鉴权**：`Authorization: Bearer <API_KEY>`
-- **提交**：`POST /v1/images/generations` → `{ "code": 200, "data": [{ "status": "submitted", "task_id": "..." }] }`
-- **查询**：`GET /v1/tasks/{task_id}`（可加 `?language=zh`），`status` 取 `pending` / `processing` / `completed` / `failed` / `cancelled`，结果在 `result.images[]`
-- **结果时效**：文档标注生成的图像链接 **有效期 72 小时**，请尽快保存
-
-任务查询字段与错误类型与平台其他模型一致（`progress`、`cost`、`credits_cost`、`created`、`completed`、`estimated_time`、`actual_time`、`error.{code,message,type}`）。
-
-## 2. 能力清单
-
-| 能力 | 触发方式 |
-|---|---|
-| 文生图 | 只传 `prompt` |
-| 图生图（参考图） | `image_urls` |
-| 组图生成 | `n > 1`（自动置 `sequential_image_generation: auto`），或显式 `sequential_image_generation: "auto"` + `sequential_image_generation_options.max_images` |
-
-## 3. 请求参数（Body）
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `model` | string | 必填 | `seedream-5-0-lite` | 也接受 `seedream-5.0-lite`、`Seedream-5.0-lite` |
-| `prompt` | string | 必填 | — | 图像生成的文本描述 |
-| `size` | string | 可选 | `1:1` | 宽高比：`1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`3:2`、`2:3`、`2:1`、`1:2`、`21:9`、`auto`（自动匹配参考图比例，需配合 `image_urls`）。`2x1`≡`2:1`、`1x2`≡`1:2`，别名中的 `x` 必须小写且无空格。**不支持 `9:21`** |
-| `resolution` | string | 可选 | `2K` | `2K` / `3K` / `4K`。**不支持 1K** |
-| `n` | integer | 可选 | `1` | 1–15。**必须是纯数字，加引号会报错**。`n > 1` 自动启用组图模式；按生成数量预扣费 |
-| `image_urls` | array | 可选 | — | 参考图 URL 或完整 Data URI（`data:image/{jpeg|png};base64,{数据}`，前缀不能省） |
-| `output_format` | string | 可选 | `jpeg` | `jpeg` / `png`。文档注明该参数为 Seedream-5.0-Lite 特有，其他图片模型传入会被忽略 |
-| `sequential_image_generation` | string | 可选 | `disabled` | `disabled` / `auto` |
-| `sequential_image_generation_options.max_images` | integer | 可选 | — | 指定生成图片数量 |
-| `watermark` | boolean | 可选 | `false` | 是否加水印 |
-| `nsfw_check` | boolean | 可选 | `false` | `true` 时用 `omni-moderation-latest` 预审提示词与输入图 |
-
-> **硬约束**：`image_urls` 中的参考图数量 + `n` 指定的生成数量必须 **≤ 15 张**。
-
-### 分辨率 × 比例 → 实际像素
-
-| 比例 | 2K | 3K | 4K |
-|---|---|---|---|
-| 1:1 | 2048×2048 | 3072×3072 | 4096×4096 |
-| 4:3 | 2304×1728 | 3456×2592 | 4704×3520 |
-| 3:4 | 1728×2304 | 2592×3456 | 3520×4704 |
-| 16:9 | 2848×1600 | 4096×2304 | 5504×3040 |
-| 9:16 | 1600×2848 | 2304×4096 | 3040×5504 |
-| 3:2 | 2496×1664 | 3744×2496 | 4992×3328 |
-| 2:3 | 1664×2496 | 2496×3744 | 3328×4992 |
-| 2:1 | 2880×1440 | 4320×2160 | 5760×2880 |
-| 1:2 | 1440×2880 | 2160×4320 | 2880×5760 |
-| 21:9 | 3136×1344 | 4704×2016 | 6240×2656 |
-
-### 参考图限制（比 Pro 更严）
-
-- 格式：jpeg、png
-- 宽高比（宽/高）：**`[1/3, 3]`**（Pro 是 `[1/16, 16]`）
-- 单边 > 14 px
-- 单张 ≤ **10 MB**（Pro 是 30 MB）
-- 总像素 ≤ 6000×6000
-
-## 4. 响应结构
-
-提交返回 `task_id`；轮询 `GET /v1/tasks/{task_id}`，成功后读 `result.images[]`，每个元素的 `url` 是**数组**（组图时一个任务返回多张）。
-
-## 5. 价格
-
-来源：[APIMart 定价中心](https://apimart.ai/zh/pricing)与 [Seedream 5.0 Lite 模型专属页](https://apimart.ai/zh/model/seedream-5-0-lite)（2026-08-30 读取，图像标签页，1 Credit ≈ $0.1）。
-
-| 规格 | 价格 |
-|---|---|
-| 默认（唯一档位） | 0.2275 Credits/张 ≈ **$0.02275/张** |
-
-定价中心显示 `SEEDREAM-5-0-LITE` 只有 1 个价格档位，未按 2K/3K/4K 分档，也未标注官方价与折扣。模型专属页的营销正文仍出现 `$0.025/张`，但同页“定价详情”和总定价中心均为 `$0.02275/张`；按调研优先级采用两个实时价格组件一致的 `$0.02275/张`。
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。本接口无这两个字段。
-- `output_format` 默认不显示、不请求。
-- 比例集合与 Pro 不同：Lite 支持 `auto`，但不支持 `9:21`；分辨率档位是 2K/3K/4K。
-- SDK 对 `4:5` / `5:4` 等官方列表外比例显式报错，不再静默回退 1:1；旧 Photoshop 插件应从本模型的比例选项中移除这两档。
-- `n` 必须以数字类型下发，序列化时不要变成字符串。
-- 组图模式下一个任务返回多张图，`result.images[].url` 数组需要整体消费。
-- 参考图宽高比被限制在 `[1/3, 3]`、单张 ≤ 10 MB，上传前应做校验，否则会被拒。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Seedream-5.0-Lite 图像生成 API | https://docs.apimart.ai/cn/api-reference/images/seedream-5-lite/generation | 否 |
-| Seedream 5.0 Lite 模型专属页（当前定价详情） | https://apimart.ai/zh/model/seedream-5-0-lite | 否 |
-| 同页纯 Markdown | https://docs.apimart.ai/cn/api-reference/images/seedream-5-lite/generation.md | 否 |
-| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
-| Webhook 回调 | https://docs.apimart.ai/cn/api-reference/tasks/webhook | 否 |
-| 定价中心（搜 SEEDREAM-5-0-LITE） | https://apimart.ai/zh/pricing | 否 |
-| API Key 管理 | https://apimart.ai/keys | **是** |
+# Seedream 5.0 Lite · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 图片 |
+| 供应商 | APIMart（聚合平台） |
+| 平台模型 ID | `seedream-5-0-lite`（兼容 `seedream-5.0-lite`、`Seedream-5.0-lite`） |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.apimart.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /v1/images/generations` → `{ "code": 200, "data": [{ "status": "submitted", "task_id": "..." }] }`
+- **查询**：`GET /v1/tasks/{task_id}`（可加 `?language=zh`），`status` 取 `pending` / `processing` / `completed` / `failed` / `cancelled`，结果在 `result.images[]`
+- **结果时效**：文档标注生成的图像链接 **有效期 72 小时**，请尽快保存
+
+任务查询字段与错误类型与平台其他模型一致（`progress`、`cost`、`credits_cost`、`created`、`completed`、`estimated_time`、`actual_time`、`error.{code,message,type}`）。
+
+## 2. 能力清单
+
+| 能力 | 触发方式 |
+|---|---|
+| 文生图 | 只传 `prompt` |
+| 图生图（参考图） | `image_urls` |
+| 组图生成 | `n > 1`（自动置 `sequential_image_generation: auto`），或显式 `sequential_image_generation: "auto"` + `sequential_image_generation_options.max_images` |
+
+## 3. 请求参数（Body）
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必填 | `seedream-5-0-lite` | 也接受 `seedream-5.0-lite`、`Seedream-5.0-lite` |
+| `prompt` | string | 必填 | — | 图像生成的文本描述 |
+| `size` | string | 可选 | `1:1` | 宽高比：`1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`3:2`、`2:3`、`2:1`、`1:2`、`21:9`、`auto`（自动匹配参考图比例，需配合 `image_urls`）。`2x1`≡`2:1`、`1x2`≡`1:2`，别名中的 `x` 必须小写且无空格。**不支持 `9:21`** |
+| `resolution` | string | 可选 | `2K` | `2K` / `3K` / `4K`。**不支持 1K** |
+| `n` | integer | 可选 | `1` | 1–15。**必须是纯数字，加引号会报错**。`n > 1` 自动启用组图模式；按生成数量预扣费 |
+| `image_urls` | array | 可选 | — | 参考图 URL 或完整 Data URI（`data:image/{jpeg|png};base64,{数据}`，前缀不能省） |
+| `output_format` | string | 可选 | `jpeg` | `jpeg` / `png`。文档注明该参数为 Seedream-5.0-Lite 特有，其他图片模型传入会被忽略 |
+| `sequential_image_generation` | string | 可选 | `disabled` | `disabled` / `auto` |
+| `sequential_image_generation_options.max_images` | integer | 可选 | — | 指定生成图片数量 |
+| `watermark` | boolean | 可选 | `false` | 是否加水印 |
+| `nsfw_check` | boolean | 可选 | `false` | `true` 时用 `omni-moderation-latest` 预审提示词与输入图 |
+
+> **硬约束**：`image_urls` 中的参考图数量 + `n` 指定的生成数量必须 **≤ 15 张**。
+
+### 分辨率 × 比例 → 实际像素
+
+| 比例 | 2K | 3K | 4K |
+|---|---|---|---|
+| 1:1 | 2048×2048 | 3072×3072 | 4096×4096 |
+| 4:3 | 2304×1728 | 3456×2592 | 4704×3520 |
+| 3:4 | 1728×2304 | 2592×3456 | 3520×4704 |
+| 16:9 | 2848×1600 | 4096×2304 | 5504×3040 |
+| 9:16 | 1600×2848 | 2304×4096 | 3040×5504 |
+| 3:2 | 2496×1664 | 3744×2496 | 4992×3328 |
+| 2:3 | 1664×2496 | 2496×3744 | 3328×4992 |
+| 2:1 | 2880×1440 | 4320×2160 | 5760×2880 |
+| 1:2 | 1440×2880 | 2160×4320 | 2880×5760 |
+| 21:9 | 3136×1344 | 4704×2016 | 6240×2656 |
+
+### 参考图限制（比 Pro 更严）
+
+- 格式：jpeg、png
+- 宽高比（宽/高）：**`[1/3, 3]`**（Pro 是 `[1/16, 16]`）
+- 单边 > 14 px
+- 单张 ≤ **10 MB**（Pro 是 30 MB）
+- 总像素 ≤ 6000×6000
+
+## 4. 响应结构
+
+提交返回 `task_id`；轮询 `GET /v1/tasks/{task_id}`，成功后读 `result.images[]`，每个元素的 `url` 是**数组**（组图时一个任务返回多张）。
+
+## 5. 价格
+
+来源：[APIMart 定价中心](https://apimart.ai/zh/pricing)与 [Seedream 5.0 Lite 模型专属页](https://apimart.ai/zh/model/seedream-5-0-lite)（2026-08-30 读取，图像标签页，1 Credit ≈ $0.1）。
+
+| 规格 | 价格 |
+|---|---|
+| 默认（唯一档位） | 0.2275 Credits/张 ≈ **$0.02275/张** |
+
+定价中心显示 `SEEDREAM-5-0-LITE` 只有 1 个价格档位，未按 2K/3K/4K 分档，也未标注官方价与折扣。模型专属页的营销正文仍出现 `$0.025/张`，但同页“定价详情”和总定价中心均为 `$0.02275/张`；按调研优先级采用两个实时价格组件一致的 `$0.02275/张`。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。本接口无这两个字段。
+- `output_format` 默认不显示、不请求。
+- 比例集合与 Pro 不同：Lite 支持 `auto`，但不支持 `9:21`；分辨率档位是 2K/3K/4K。
+- SDK 对 `4:5` / `5:4` 等官方列表外比例显式报错，不再静默回退 1:1；旧 Photoshop 插件应从本模型的比例选项中移除这两档。
+- `n` 必须以数字类型下发，序列化时不要变成字符串。
+- 组图模式下一个任务返回多张图，`result.images[].url` 数组需要整体消费。
+- 参考图宽高比被限制在 `[1/3, 3]`、单张 ≤ 10 MB，上传前应做校验，否则会被拒。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Seedream-5.0-Lite 图像生成 API | https://docs.apimart.ai/cn/api-reference/images/seedream-5-lite/generation | 否 |
+| Seedream 5.0 Lite 模型专属页（当前定价详情） | https://apimart.ai/zh/model/seedream-5-0-lite | 否 |
+| 同页纯 Markdown | https://docs.apimart.ai/cn/api-reference/images/seedream-5-lite/generation.md | 否 |
+| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
+| Webhook 回调 | https://docs.apimart.ai/cn/api-reference/tasks/webhook | 否 |
+| 定价中心（搜 SEEDREAM-5-0-LITE） | https://apimart.ai/zh/pricing | 否 |
+| API Key 管理 | https://apimart.ai/keys | **是** |

package/docs/model-adaptation/Seedream-5.0-Lite/Seedream-5.0-Lite_Fal.md

@@ -1,91 +1,91 @@
-# Seedream 5.0 Lite · Fal
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-28 |
-| 模态 | 图片 |
-| 供应商 | fal.ai（聚合平台） |
-| 平台模型 ID | `bytedance/seedream/v5/lite/text-to-image`、`bytedance/seedream/v5/lite/edit` |
-| 接口形态 | 队列异步（推荐）或同步直连 |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-## 1. 接入协议（Fal 通用）
-
-- **鉴权**：`Authorization: Key $FAL_KEY`
-- **同步**：`POST https://fal.run/<endpoint-id>`
-- **队列**：`POST https://queue.fal.run/<endpoint-id>` → `{ request_id, status_url, response_url, cancel_url }`；`GET .../requests/{id}/status`（`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`）；`GET .../requests/{id}` 取结果
-- **Webhook**：提交时加 `?fal_webhook=<url>`
-- **计费**：按输出计费，服务端错误与排队时间不计费
-- **权威 schema**：`https://fal.ai/models/<endpoint-id>/llms.txt`
-
-## 2. 能力清单
-
-| 能力 | endpoint id |
-|---|---|
-| 文生图（含组图） | `bytedance/seedream/v5/lite/text-to-image` |
-| 图像编辑 / 多参考图（最多 10 张） | `bytedance/seedream/v5/lite/edit` |
-
-## 3. 请求参数（两个端点共有）
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `prompt` | string | 必填 | — | 生成 / 编辑描述 |
-| `image_size` | 枚举或对象 | 可选 | `auto_2K` | 枚举：`square_hd`、`square`、`portrait_4_3`、`portrait_16_9`、`landscape_4_3`、`landscape_16_9`、`auto_1K`、`auto_2K`；或 `{ width, height }`。**总像素须在 2560×1440 ~ 4096×4096 之间；不满足时 Fal 会自动缩放而不是报错** |
-| `num_images` | integer | 可选 | `1` | 1–6，独立运行的生成次数 |
-| `max_images` | integer | 可选 | `1` | 1–6。大于 1 时开启组图：每次生成最多返回 `max_images` 张，共跑 `num_images` 次，总数在 `num_images` ~ `max_images × num_images` 之间 |
-| `sync_mode` | boolean | 可选 | `false` | `true` 时以 data URI 返回且不入请求历史 |
-| `enable_safety_checker` | boolean | 可选 | `true` | 关闭需账号授权 |
-
-**仅 `text-to-image` 有：**
-
-| 字段 | 类型 | 默认 | 说明 |
-|---|---|---|---|
-| `return_byteplus_urls` | boolean | `false` | `true` 时返回 seedance-2 可信 URL，**该链接 24 小时过期** |
-
-**仅 `edit` 有：**
-
-| 字段 | 类型 | 必填 | 说明 |
-|---|---|---|---|
-| `image_urls` | string[] | 必填 | 输入图 URL 列表。**目前最多 10 张；超过时只取最后 10 张**（静默截断） |
-
-> Fal 的 Lite 端点**没有 `output_format`**（Pro 有）。
-
-## 4. 响应结构
-
-```json
-{ "images": [ { "url": "https://v3b.fal.media/files/b/.../xxx.png" } ], "seed": 42 }
-```
-
-`images` 与 `seed` 都是必返回字段——**`seed` 只是回传本次生成用的种子，不是入参**，本项目按规则不展示它。
-
-## 5. 价格
-
-来源：两个端点的 `llms.txt`（2026-08-22 读取）。
-
-| 端点 | 单价 |
-|---|---|
-| `text-to-image` | **$0.035 / 张** |
-| `edit` | **$0.035 / 张** |
-
-Fal 未对 Lite 按分辨率分档，也未标注输入图加价。
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。入参无 `seed`；输出里的 `seed` 只做记录，不要暴露成可编辑参数。
-- `sync_mode`、`return_byteplus_urls` 不展示、不请求。
-- 尺寸约束与 Pro 不同（Lite 是 2560×1440 ~ 4096×4096），越界会被**自动缩放**而不是报错，UI 上给出的固定比例需要按 Lite 的面积区间换算。
-- SDK 固定比例覆盖通用 10 档；显式 `1MP` 是旧插件请求兼容档，会发送约 1024²、16 对齐的对象，但该面积低于 Lite 官方下限，Fal 会自动放大。新宿主应优先选择 2K/3K/4K；默认仍保持 0.1.5 的 2K。
-- 组图靠 `max_images`（Fal 独有写法），与 APIMart 的 `n` / 火山的 `sequential_image_generation` 都不一样。
-- `image_urls` 超 10 张静默截断，需前端限制。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| 文生图模型页 | https://fal.ai/models/bytedance/seedream/v5/lite/text-to-image | 否 |
-| 文生图 schema + 价格 | https://fal.ai/models/bytedance/seedream/v5/lite/text-to-image/llms.txt | 否 |
-| 编辑模型页 | https://fal.ai/models/bytedance/seedream/v5/lite/edit | 否 |
-| 编辑 schema + 价格 | https://fal.ai/models/bytedance/seedream/v5/lite/edit/llms.txt | 否 |
-| 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
-| API Key 创建 | https://fal.ai/dashboard/keys | **是** |
+# Seedream 5.0 Lite · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 模态 | 图片 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `bytedance/seedream/v5/lite/text-to-image`、`bytedance/seedream/v5/lite/edit` |
+| 接口形态 | 队列异步（推荐）或同步直连 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议（Fal 通用）
+
+- **鉴权**：`Authorization: Key $FAL_KEY`
+- **同步**：`POST https://fal.run/<endpoint-id>`
+- **队列**：`POST https://queue.fal.run/<endpoint-id>` → `{ request_id, status_url, response_url, cancel_url }`；`GET .../requests/{id}/status`（`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`）；`GET .../requests/{id}` 取结果
+- **Webhook**：提交时加 `?fal_webhook=<url>`
+- **计费**：按输出计费，服务端错误与排队时间不计费
+- **权威 schema**：`https://fal.ai/models/<endpoint-id>/llms.txt`
+
+## 2. 能力清单
+
+| 能力 | endpoint id |
+|---|---|
+| 文生图（含组图） | `bytedance/seedream/v5/lite/text-to-image` |
+| 图像编辑 / 多参考图（最多 10 张） | `bytedance/seedream/v5/lite/edit` |
+
+## 3. 请求参数（两个端点共有）
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `prompt` | string | 必填 | — | 生成 / 编辑描述 |
+| `image_size` | 枚举或对象 | 可选 | `auto_2K` | 枚举：`square_hd`、`square`、`portrait_4_3`、`portrait_16_9`、`landscape_4_3`、`landscape_16_9`、`auto_1K`、`auto_2K`；或 `{ width, height }`。**总像素须在 2560×1440 ~ 4096×4096 之间；不满足时 Fal 会自动缩放而不是报错** |
+| `num_images` | integer | 可选 | `1` | 1–6，独立运行的生成次数 |
+| `max_images` | integer | 可选 | `1` | 1–6。大于 1 时开启组图：每次生成最多返回 `max_images` 张，共跑 `num_images` 次，总数在 `num_images` ~ `max_images × num_images` 之间 |
+| `sync_mode` | boolean | 可选 | `false` | `true` 时以 data URI 返回且不入请求历史 |
+| `enable_safety_checker` | boolean | 可选 | `true` | 关闭需账号授权 |
+
+**仅 `text-to-image` 有：**
+
+| 字段 | 类型 | 默认 | 说明 |
+|---|---|---|---|
+| `return_byteplus_urls` | boolean | `false` | `true` 时返回 seedance-2 可信 URL，**该链接 24 小时过期** |
+
+**仅 `edit` 有：**
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `image_urls` | string[] | 必填 | 输入图 URL 列表。**目前最多 10 张；超过时只取最后 10 张**（静默截断） |
+
+> Fal 的 Lite 端点**没有 `output_format`**（Pro 有）。
+
+## 4. 响应结构
+
+```json
+{ "images": [ { "url": "https://v3b.fal.media/files/b/.../xxx.png" } ], "seed": 42 }
+```
+
+`images` 与 `seed` 都是必返回字段——**`seed` 只是回传本次生成用的种子，不是入参**，本项目按规则不展示它。
+
+## 5. 价格
+
+来源：两个端点的 `llms.txt`（2026-08-22 读取）。
+
+| 端点 | 单价 |
+|---|---|
+| `text-to-image` | **$0.035 / 张** |
+| `edit` | **$0.035 / 张** |
+
+Fal 未对 Lite 按分辨率分档，也未标注输入图加价。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。入参无 `seed`；输出里的 `seed` 只做记录，不要暴露成可编辑参数。
+- `sync_mode`、`return_byteplus_urls` 不展示、不请求。
+- 尺寸约束与 Pro 不同（Lite 是 2560×1440 ~ 4096×4096），越界会被**自动缩放**而不是报错，UI 上给出的固定比例需要按 Lite 的面积区间换算。
+- SDK 固定比例覆盖通用 10 档；显式 `1MP` 是旧插件请求兼容档，会发送约 1024²、16 对齐的对象，但该面积低于 Lite 官方下限，Fal 会自动放大。新宿主应优先选择 2K/3K/4K；默认仍保持 0.1.5 的 2K。
+- 组图靠 `max_images`（Fal 独有写法），与 APIMart 的 `n` / 火山的 `sequential_image_generation` 都不一样。
+- `image_urls` 超 10 张静默截断，需前端限制。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文生图模型页 | https://fal.ai/models/bytedance/seedream/v5/lite/text-to-image | 否 |
+| 文生图 schema + 价格 | https://fal.ai/models/bytedance/seedream/v5/lite/text-to-image/llms.txt | 否 |
+| 编辑模型页 | https://fal.ai/models/bytedance/seedream/v5/lite/edit | 否 |
+| 编辑 schema + 价格 | https://fal.ai/models/bytedance/seedream/v5/lite/edit/llms.txt | 否 |
+| 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
+| API Key 创建 | https://fal.ai/dashboard/keys | **是** |