@henjicc/ai-sdk 0.9.0 → 0.10.0

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 | **是** |

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

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

@@ -1,108 +1,110 @@
-# 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 | **是** |
+# Seedream 5.0 Lite · 火山引擎（火山方舟，官方）
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 图片 |
+| 供应商 | 火山引擎 · 火山方舟（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」的约束。
+- 价格计算中的参考图数量必须同时识别生成提交、画布和对话/工具面板的三套媒体字段，避免空的本地路径数组遮蔽实时图片数组，进而把可生成张数和总价算高。
+
+- 界面与请求一致（2026-11-08“所选即所发”离线检查）：输入图加输出张数不超过 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 | **是** |