@henjicc/ai-sdk 0.2.8

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

@@ -0,0 +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 | **是** |

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

@@ -0,0 +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 | **是** |

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

@@ -0,0 +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 | **是** |

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

@@ -0,0 +1,89 @@
+# Seedream 5.0 Lite · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-22 |
+| 模态 | 图片 |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID | `seedream/5-lite-text-to-image`、`seedream/5-lite-image-to-image` |
+| 接口形态 | **异步任务**（`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=...`
+- **终态**：`state` ∈ `waiting` / `queuing` / `generating` / `success` / `fail`；成功后 `JSON.parse(resultJson)` 取 `resultUrls`
+- **失败**：读 `failCode` / `failMsg`
+
+## 2. 能力清单
+
+| 能力 | model |
+|---|---|
+| 文生图 | `seedream/5-lite-text-to-image` |
+| 图片编辑 / 多参考图 | `seedream/5-lite-image-to-image` |
+
+> KIE 上的 Seedream 5.0 Lite **没有组图（sequential）专用端点**，`input` 中也没有数量字段——单次请求出 1 张。需要组图请走火山引擎官方或 APIMart。
+
+## 3. 请求参数
+
+### 3.1 `seedream/5-lite-text-to-image`
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | 必填 | — | 3–3000 字符 |
+| `input.aspect_ratio` | string | 必填 | `1:1` | `1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`2:3`、`3:2`、`21:9` |
+| `input.quality` | string | 必填 | `basic` | **`basic` = 2K，`high` = 3K，`ultra` = 4K** |
+| `input.output_format` | string | 可选 | `png` | `png` / `jpeg` |
+| `input.nsfw_checker` | boolean | 可选 | `false` | 设 `false` 关闭内容过滤；平台声明不保证全部过滤 |
+
+### 3.2 `seedream/5-lite-image-to-image`
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | 必填 | — | 3–3000 字符 |
+| `input.image_urls` | array | 必填 | — | **最多 14 张**。传上传后的文件 URL；支持 image/jpeg、image/png、image/webp；单张 ≤ 30 MB |
+| `input.aspect_ratio` | string | 必填 | `1:1` | 同上 8 个比例 |
+| `input.quality` | string | 必填 | `basic` | `basic` = 2K，`high` = 3K，`ultra` = 4K |
+| `input.output_format` | string | 可选 | `png` | `png` / `jpeg` |
+| `input.nsfw_checker` | boolean | 可选 | `false` | 同上 |
+
+> 参考图上限 **14 张**（Pro 是 10 张），与火山官方 Lite 的 14 张一致。
+
+## 4. 响应结构
+
+`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`。
+
+## 5. 价格
+
+来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `seedream 5.0 Lite`；1 Credit = $0.005）。
+
+| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 |
+|---|---|---|---|
+| 文生图 | 5.5 /张 | **$0.0275/张** | $0.035 |
+| 图片编辑 | 5.5 /张 | **$0.0275/张** | $0.035 |
+
+KIE 的 Lite 价格不分 2K/3K/4K 档位，统一单价。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。本接口无这两个字段。
+- `output_format` 默认不显示、不请求。
+- **`quality` 的语义在 Lite 与 Pro 完全不同**：Lite 是 `basic/high/ultra` → 2K/3K/4K，Pro 是 `basic/high` → 1K/2K。不能共用映射。
+- 无参考图走 `text-to-image`，1–14 张走 `image-to-image`，在同一模型下路由。
+- `resultJson` 是 JSON 字符串，必须二次 parse。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Seedream 5.0 Lite 文生图 | https://docs.kie.ai/cn/market/seedream/5-lite-text-to-image | 否 |
+| Seedream 5.0 Lite 图片编辑 | https://docs.kie.ai/cn/market/seedream/5-lite-image-to-image | 否 |
+| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| 文件上传 | https://docs.kie.ai/cn/file-upload-api/upload-file-url | 否 |
+| 定价页（搜 `seedream 5.0 Lite`） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |

package/docs/model-adaptation/Seedream-5.0-Lite/Seedream-5.0-Lite_/347/201/253/345/261/261/345/274/225/346/223/216.md

@@ -0,0 +1,108 @@
+# Seedream 5.0 Lite · 火山引擎（火山方舟，官方）
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 图片 |
+| 供应商 | 火山引擎 · 火山方舟（Ark），模型原厂官方接口 |
+| 平台模型 ID | `doubao-seedream-5-0-260128`（同时支持写作 `doubao-seedream-5-0-lite-260128`） |
+| 接口形态 | **同步**，可选流式（`stream: true`） |
+| 文档可见性 | 公开，无需登录；调用需 API Key |
+| 价格可见性 | 公开，无需登录 |
+| 官方文档最后更新 | 2026-08-12 |
+
+## 1. 接入协议
+
+与 Seedream 5.0 Pro 共用同一个接口：
+
+- **接口**：`POST https://ark.cn-beijing.volces.com/api/v3/images/generations`
+- **鉴权**：`Authorization: Bearer $ARK_API_KEY`
+- **结果时效**：`response_format=url` 返回的链接 **24 小时内有效**
+
+## 2. 能力清单（与 Pro 差异很大，勿混）
+
+| 能力 | 说明 | 触发方式 |
+|---|---|---|
+| 文生图 | 单图 | 不传 `image`，`sequential_image_generation: disabled` |
+| 单图生图 | 1 张参考图 | `image` 传 1 张 |
+| 多图生图 | **2–14 张**参考图 → 单图 | `image` 传数组 |
+| 文生组图 | 最多 15 张 | `sequential_image_generation: "auto"` |
+| 单图生组图 | 最多 14 张 | 1 张 `image` + `auto` |
+| 多图生组图 | 输入参考图数 + 生成图数 ≤ 15 | 多张 `image` + `auto` |
+| 流式输出 | 每张图生成完即时返回 | `stream: true` |
+| 联网搜索 | 模型自主判断是否搜索互联网内容 | `tools: [{ "type": "web_search" }]` |
+
+**Lite 不支持**：图层拆分（`layer_decomposition`）、透明背景（`background`）——这两项是 Pro 独有。
+
+## 3. 请求参数（Body）
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必选 | — | `doubao-seedream-5-0-260128` |
+| `prompt` | string | 必选 | — | 支持中英文。建议中文 ≤ 300 字、英文 ≤ 600 词 |
+| `image` | string / string[] | 可选 | — | 参考图，URL 或 `data:image/<小写格式>;base64,<编码>`。Lite **最多 14 张** |
+| `size` | string | 可选 | 方式 2 下为 `2048x2048` | 见下 |
+| `optimize_prompt_options.mode` | string | 可选 | `standard` | `standard`；**Lite 当前不支持 `fast`** |
+| `output_format` | string | 可选 | `jpeg` | `png` / `jpeg` |
+| `response_format` | string | 可选 | `url` | `url`（24 小时有效）/ `b64_json` |
+| `sequential_image_generation` | string | 可选 | `disabled` | `disabled` / `auto`（组图） |
+| `sequential_image_generation_options.max_images` | integer | 可选 | `15` | 取值 `[1, 15]`。**输入参考图数 + 最终生成数 ≤ 15** |
+| `stream` | boolean | 可选 | `false` | 流式输出 |
+| `tools[].type` | string | 可选 | — | `web_search`；实际搜索次数见 `usage.tool_usage.web_search` |
+| `watermark` | boolean | 可选 | **`true`** | 官方默认加「AI 生成」水印，需要关闭必须显式传 `false` |
+
+### size 取值（两种方式不可混用）
+
+- 方式 1：分辨率档位 `2K` / `3K` / `4K`，宽高比由 prompt 自然语言描述后模型判断。**Lite 没有 1K / 1.5K 档。**
+- 方式 2：精确像素 `宽x高`，默认 `2048x2048`。总像素范围 `[3686400 (2560×1440), 16777216 (4096×4096)]`，宽高比 `[1/16, 16]`，两个条件需同时满足。有效示例 `3750x1250`；无效示例 `1500x1500`（总像素不足）。
+
+档位 → 宽高像素映射（官方参考值）：
+
+| 分辨率 | 1:1 | 4:3 | 3:4 | 16:9 | 9:16 | 3:2 | 2:3 | 21:9 |
+|---|---|---|---|---|---|---|---|---|
+| 2K | 2048×2048 | 2304×1728 | 1728×2304 | 2848×1600 | 1600×2848 | 2496×1664 | 1664×2496 | 3136×1344 |
+| 3K | 3072×3072 | 3456×2592 | 2592×3456 | 4096×2304 | 2304×4096 | 3744×2496 | 2496×3744 | 4704×2016 |
+| 4K | 4096×4096 | 4704×3520 | 3520×4704 | 5504×3040 | 3040×5504 | 4992×3328 | 3328×4992 | 6240×2656 |
+
+### 输入图片限制
+
+格式 jpeg/png/webp/bmp/tiff/gif/heic/heif；宽高比 `[1/16, 16]`；单边 > 14 px；≤ 30 MB；总像素 `[196, 36000000]`。
+
+## 4. 响应结构
+
+顶层 `created` / `model` / `data[]` / `error` / `tools[]` / `usage`。`data[]` 含 `url` 或 `b64_json`、`size`、`output_format`。
+
+**组图场景**：某张图失败时该元素额外返回 `data[].error`，其他图不受影响。官方说明：若失败原因是审核不通过，会继续生成后续图片；若是内部服务异常（500），不再继续。
+
+流式响应的事件结构见「图片生成流式响应事件」文档。
+
+## 5. 价格（官方，人民币）
+
+来源：火山方舟「模型价格」（更新于 2026-08-20）。
+
+| 模型 | 输入图 | 输出 |
+|---|---|---|
+| `doubao-seedream-5-0-lite` | 免费 | **0.22 元/张** |
+
+组图场景按**实际生成的图片数量**计费。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。官方接口无这两个字段。
+- `watermark` 官方默认 `true`，必须显式传 `false`。
+- `output_format` 默认不显示、不请求。
+- Lite 的分辨率档位是 **2K/3K/4K**，与 Pro 的 1K/1.5K/2K 完全不同，比例与档位映射也不同，不能共用一套映射表。
+- 组图能力会改变返回数量与计费，若产品要开放，需要在 UI 上明确「输入参考图数 + 生成数 ≤ 15」的约束。
+- 价格计算中的参考图数量必须同时识别生成提交、画布和对话/工具面板的三套媒体字段，避免空的本地路径数组遮蔽实时图片数组，进而把可生成张数和总价算高。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 图片生成 API（Pro/Lite/4.5/4.0 合并文档） | https://console.volcengine.com/ark/region:cn-beijing/docs/82379/1541523?lang=zh | 否 |
+| 公开镜像 | https://www.volcengine.com/docs/82379/1541523 | 否 |
+| 图片生成流式响应事件 | https://www.volcengine.com/docs/82379/1824137 | 否 |
+| 模型价格 | https://www.volcengine.com/docs/82379/1544106 | 否 |
+| 模型列表（Model ID / 限流 / 能力） | https://www.volcengine.com/docs/82379/1330310 | 否 |
+| Seedream 图像创作教程（组图、流式示例） | https://www.volcengine.com/docs/82379/1824121 | 否 |
+| API Key 管理 | https://console.volcengine.com/ark/region:cn-beijing/apiKey | **是** |