@henjicc/ai-sdk 0.2.8

package/docs/model-adaptation/Seedream-5.0-Pro/Seedream-5.0-Pro_APIMart.md

@@ -0,0 +1,194 @@
+# Seedream 5.0 Pro · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 图片 |
+| 供应商 | APIMart（聚合平台） |
+| 平台模型 ID | `seedream-5-0-pro`（兼容 `seedream-5.0-pro`） |
+| 接口形态 | **异步任务**：提交返回 `task_id`，轮询统一任务接口 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.apimart.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`（在 https://apimart.ai/keys 获取）
+- **提交**：`POST /v1/images/generations`
+- **查询**：`GET /v1/tasks/{task_id}`，可加 `?language=zh|en|ko|ja`（默认英文）
+- **轮询建议**：官方提示本模型较慢，1K 约 90 秒、2K 约 160 秒；每 5–10 秒轮询一次，客户端超时建议 **5 分钟**
+- **结果存储**：输出图片已镜像到 APIMart 自有存储并返回平台 URL，但仍需业务侧及时下载持久化（响应含 `expires_at`）
+
+提交响应：
+
+```json
+{ "code": 200, "data": [ { "status": "submitted", "task_id": "task_01K8SGYNNNVBQTXNR4MM964S7K" } ] }
+```
+
+任务查询响应（关键字段）：
+
+| 字段 | 说明 |
+|---|---|
+| `id` | 任务 ID |
+| `status` | `pending` / `processing` / `completed` / `failed` / `cancelled` |
+| `progress` | 0–100 |
+| `cost` / `credits_cost` | 本次扣费金额 / 积分 |
+| `result.images[]` | 图像结果数组（视频任务为 `result.videos[]`） |
+| `created` / `completed` / `estimated_time` / `actual_time` | 时间戳与耗时（秒） |
+| `error.{code,message,type}` | 仅 `failed` 时存在 |
+
+错误类型：400 `invalid_request_error`、401 `authentication_error`、402 `payment_required`、403 `permission_error`、429 `rate_limit_error`、500 `server_error`、502 `bad_gateway`。
+
+## 2. 能力清单
+
+| 能力 | 触发方式 |
+|---|---|
+| 文生图 | 只传 `prompt` |
+| 单图 / 多图生图（最多 10 张参考图） | `image_urls` |
+| 交互编辑（坐标 / 框选 / 手绘标记） | `prompt` 中写 `<point>x y</point>` 或 `<bbox>x1 y1 x2 y2</bbox>`（归一化到 0–1000），或上传带手绘标记的图 |
+| 图层拆分（1 底图 + 最多 16 层） | `layer_decomposition: true` + 恰好 1 张 `image_urls` |
+| 透明通道编辑 | `background: "transparent"` + 恰好 1 张带透明通道的输入图 + `output_format: "png"` |
+
+**平台会直接拒绝（400，不建任务、不扣费）**：`n > 1`、`sequential_image_generation`、`stream`、`tools`、`image_urls` 超过 10 张。
+
+## 3. 请求参数（Body）
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必填 | `seedream-5-0-pro` | `seedream-5-0-pro`（推荐），亦接受 `seedream-5.0-pro` |
+| `prompt` | string | 必填 | — | 使用 `layer_decomposition: true` 时可省略。建议 ≤ 600 英文单词。除中英文外支持俄/阿/菲/泰/土/韩/马来/西/葡/印尼/法/德/越/日语的原生文字生成 |
+| `resolution` | string | 可选 | `1K` | APIMart 扩展字段。`1K` / `1.5K` / `2K`（兼容小写）。**1.5K 与 1K 同价、画质更好，无特殊理由优先 1.5K**。传 3K/4K 返回 400。与档位形式的 `size` 同传时以 `size` 为准；`size` 为精确像素时本字段被忽略 |
+| `size` | string | 可选 | `auto` | 三种写法，见下 |
+| `image_urls` | array | 可选 | — | 参考图 URL 列表，**最多 10 张**。支持公网 `http(s)` URL 或 `data:image/<小写格式>;base64,<编码>` |
+| `background` | string | 可选 | `opaque` | `opaque` / `transparent`。`transparent` 只能用于图生图，且必须恰好 1 张本身带透明通道的输入图，同时 `output_format: "png"` |
+| `layer_decomposition` | boolean | 可选 | `false` | 图层拆分。开启时必须恰好 1 张 PNG/JPEG 图，总像素 `[262144, 36000000]`、≤ 30 MB；`size` 只接受 `1K`/`1.5K`/`2K`/`auto`（默认 `auto`）；`output_format` 只控制底图，图层恒为 PNG |
+| `optimize_prompt_options` | object | 可选 | `{"mode":"standard"}` | 仅支持 `standard`。兼容扁平写法 `"optimize_prompt_options.mode": "standard"` |
+| `output_format` | string | 可选 | `jpeg` | `jpeg` / `png`。`response_format` 与之等价，其余取值按 `jpeg` 处理 |
+| `watermark` | boolean | 可选 | **`false`** | 右下角 "AI generated" 水印。注意与火山官方默认（`true`）相反 |
+| `nsfw_check` | boolean | 可选 | `false` | `true` 时用 `omni-moderation-latest` 预审提示词与输入图，会增加成本与延迟 |
+| `n` | integer | 可选 | `1` | **只能为 1**。需要组图请改用 `seedream-5-0-lite` |
+
+### size 三种写法
+
+**写法 ①：档位**——`{"size":"2K"}` 与 `{"resolution":"2K"}` 等价，宽高比交给模型判断。
+
+**写法 ②：档位 + 宽高比**——与 `resolution` 配合。支持 `1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`3:2`、`2:3`、`2:1`、`1:2`、`21:9`、`auto`；兼容 `16x9` 小写 `x` 写法（不能有空格）。**列表外的比例（如 `9:21`）直接返回 400，不会静默回退成 1:1**。
+
+| 分辨率 | 1:1 | 4:3 | 3:4 | 16:9 | 9:16 | 3:2 | 2:3 | 2:1 | 1:2 | 21:9 |
+|---|---|---|---|---|---|---|---|---|---|---|
+| 1K | 1024×1024 | 1152×864 | 864×1152 | 1312×736 | 736×1312 | 1248×832 | 832×1248 | 1440×720 | 720×1440 | 1568×672 |
+| 1.5K | 1536×1536 | 1792×1344 | 1344×1792 | 2048×1152 | 1152×2048 | 1872×1248 | 1248×1872 | 2176×1088 | 1088×2176 | 2352×1008 |
+| 2K | 2048×2048 | 2304×1728 | 1728×2304 | 2560×1440 | 1440×2560 | 2496×1664 | 1664×2496 | 2880×1440 | 1440×2880 | 3024×1296 |
+
+> 注：APIMart 的档位映射与火山官方文档的映射表在 16:9 / 4:3 等档位上数值略有差异，以调用平台的表为准。
+
+**写法 ③：精确像素**——`宽x高`（兼容 `2048X1024` / `2048×1024`），此时 `resolution` 不参与。总像素须在 `[921600, 4624220]`，宽高比须在 `[1/16, 16]`；限制的是**乘积**不是单边（`512×512` 会 400，`2048×1024` 合法）。
+
+### 单张参考图限制
+
+格式 jpeg/png/webp/bmp/tiff/gif/heic/heif；宽高比 `[1/16, 16]`；单边 > 14 px；≤ 30 MB；总像素 ≤ 36,000,000。
+
+## 4. 响应结构
+
+普通生成，`GET /v1/tasks/{task_id}` 成功时：
+
+```json
+{
+  "id": "task_01JFXYZ123456789ABCDEF",
+  "status": "success",
+  "progress": 100,
+  "cost": 0.045,
+  "result": {
+    "images": [
+      { "url": ["https://cdn.example.com/images/image_task_xxx_0.png"],
+        "sizes": ["2048x1152"], "output_formats": ["png"], "expires_at": 1784696685 }
+    ]
+  }
+}
+```
+
+> 注意：`url` 是**数组**，不是字符串。文档中同时出现 `status: "completed"`（任务接口定义）与 `status: "success"`（示例），解析时两者都要当作终态成功处理。
+
+**图层拆分响应**：`url`、`sizes`、`output_formats` 与 `layers` 数组**按下标一一对应，下标 0 恒为底图**：
+
+```json
+{ "result": { "images": [{
+  "url": ["...image_task_xxx_0.jpeg", "...image_task_xxx_1.png", "...image_task_xxx_2.png"],
+  "sizes": ["2048x2048", "1273x265", "492x98"],
+  "output_formats": ["jpeg", "png", "png"],
+  "layer_decomposition": true,
+  "layers": [
+    { "z_index": 0, "size": "2048x2048", "output_format": "jpeg" },
+    { "z_index": 1, "size": "1273x265", "output_format": "png", "name": "标题文字",
+      "description": "黄色大号衬线字体的标题文字",
+      "bounding_box": { "absolute": [383,120,1655,384], "normalized": [187,59,808,188] } }
+  ]
+}]}}
+```
+
+还原方式：按 `z_index` 从小到大叠放；`absolute` 用于还原到输出底图，`normalized`（0–1000）用于还原到任意 `W×H` 画布。
+
+## 5. 价格
+
+**公开来源曾经不一致；2026-08-30 重新核验后，模型专属页的“定价详情”和总定价中心已统一为下列当前生效价。API 文档正文仍是旧价。**
+
+来源 A —— [APIMart 定价中心](https://apimart.ai/zh/pricing)与 [Seedream 5.0 Pro 模型专属页](https://apimart.ai/zh/model/seedream-5-0-pro)（2026-08-30 读取，图像标签页，1 Credit ≈ $0.1）：
+
+| 规格 | 价格 |
+|---|---|
+| 默认 | 0.36 Credits/张 ≈ **$0.036/张** |
+| 1K / 1.5K | 0.2925 Credits/张 ≈ **$0.02925/张** |
+| 2K | 0.585 Credits/张 ≈ **$0.0585/张** |
+| 第 2 张起的参考图片 | 0.0195 Credits/张 ≈ **$0.00195/张**（第 1 张免费） |
+| 1K / 1.5K-layer（图层拆分） | 0.14625 Credits/输出图层 ≈ **$0.014625/输出图层** |
+| 2K / auto-layer（图层拆分） | 0.2925 Credits/输出图层 ≈ **$0.02925/输出图层** |
+
+来源 B —— API 文档「计费说明」章节：
+
+| 条件 | 单价 |
+|---|---|
+| 总像素 ≤ 2.61M（`resolution` 为 `1K`/`1.5K`/不传，或精确像素 ≤ 2,601,124） | $0.045/张 |
+| 总像素 > 2.61M（`resolution: "2K"`，或精确像素 > 2,601,124） | $0.09/张 |
+
+共同规则：1.5K 与 1K 同价；`size` 为精确像素时按**实际输出面积**判档，`resolution` 不影响；**第 1 张参考图免费，第 2 张起每张 $0.00195**；任务失败自动全额退款。
+
+**图层拆分的预扣与结算**：提交时按 **17 张**保守预扣（`1K`/`1.5K` 按 1K 档，`2K` 与 `auto` 按 2K 档），账户余额必须能覆盖 17 张预扣；完成后按底图与每个实际图层的真实像素面积**逐张判档求和**结算，多扣自动退回。SDK 本地计算器无法在结果返回前知道总图层数，因此图层模式返回“暂不可估算”（`NaN`），不能把一个图层的单位价冒充最终总价；上表单位价仅用于解释实际账单。
+
+## 6. 常见错误（文档明列）
+
+| 场景 | 结果 |
+|---|---|
+| `resolution` 传 3K/4K | 400 |
+| `size` 既非档位/`auto`，也非支持比例或合法像素 | 400 |
+| 精确像素总像素越界（须在 `[921600, 4624220]`）或宽高比越界（`[1/16,16]`） | 400 |
+| `n > 1` 或组图参数 | 拒绝（单图模型） |
+| 参考图超过 10 张 | 拒绝 |
+| 图层拆分未传图或传多张 | 必须恰好 1 张 |
+| 图层拆分使用比例或精确像素 | `size` 仅支持 `1K`/`1.5K`/`2K`/`auto` |
+| 透明背景用于文生图或多图 | 必须恰好 1 张带透明通道的图 |
+| 透明背景 + JPEG | 须设 `output_format: "png"` |
+| `stream` / `tools` | 本模型不支持，直接 400 |
+| 提示词优化模式非法 | 仅支持 `standard` |
+
+## 7. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。本接口无这两个字段。
+- `output_format` 默认不显示且不请求。
+- 普通生成 / 编辑估价需要把输出价与参考图加价相加：`输出价 + max(0, 参考图数量 - 1) × $0.00195`。图层拆分在生成前返回“暂不可估算”，最终总价以后端实际输出图层数与结算为准。
+- Pro 是单图模型，UI 不要出现数量选择；比例集合必须严格取平台支持列表，越界会 400 而不是回退。
+- SDK 已补齐合法的 `2:1` / `1:2`，并对 `4:5` / `5:4` 等列表外比例显式报错；旧 Photoshop 插件不能继续把 COMMON10 原样用于本模型。
+- 图层拆分与普通生成的结果结构不同（多 URL + `layers` 元数据），必须作为独立能力分支，不能与普通出图混发。
+- 轮询超时按 5 分钟设置，明显长于普通图片模型。
+
+## 8. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Seedream-5.0-Pro 图像生成 API（参数、示例、图层拆分、计费、错误） | https://docs.apimart.ai/cn/api-reference/images/seedream-5-0-pro/generation | 否 |
+| Seedream 5.0 Pro 模型专属页（当前定价详情与参考图加价） | https://apimart.ai/zh/model/seedream-5-0-pro | 否 |
+| 同页纯 Markdown | https://docs.apimart.ai/cn/api-reference/images/seedream-5-0-pro/generation.md | 否 |
+| 获取任务状态（统一轮询协议） | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
+| Webhook 回调 | https://docs.apimart.ai/cn/api-reference/tasks/webhook | 否 |
+| 定价中心（图像标签页搜 SEEDREAM-5-0-PRO） | https://apimart.ai/zh/pricing | 否 |
+| API Key 管理 | https://apimart.ai/keys | **是** |
+| 文档总索引 | https://docs.apimart.ai/llms.txt | 否 |

package/docs/model-adaptation/Seedream-5.0-Pro/Seedream-5.0-Pro_Fal.md

@@ -0,0 +1,100 @@
+# Seedream 5.0 Pro · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 图片 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `bytedance/seedream/v5/pro/text-to-image`、`bytedance/seedream/v5/pro/edit` |
+| 接口形态 | 队列异步（推荐）或同步直连 |
+| 文档可见性 | 公开，无需登录（每个模型都有 `llms.txt` 实时 schema） |
+| 价格可见性 | 公开，无需登录（写在模型 `llms.txt` 与定价页） |
+
+## 1. 接入协议（Fal 通用）
+
+- **鉴权**：`Authorization: Key $FAL_KEY`（在 https://fal.ai/dashboard/keys 创建）
+- **同步调用**：`POST https://fal.run/<endpoint-id>`
+- **队列提交**：`POST https://queue.fal.run/<endpoint-id>`，返回 `{ request_id, status_url, response_url, cancel_url }`
+- **查询状态**：`GET https://queue.fal.run/<app>/requests/{request_id}/status`，`status` 取值 `IN_QUEUE`（含 `queue_position`）/ `IN_PROGRESS` / `COMPLETED`
+- **取结果**：`GET https://queue.fal.run/<app>/requests/{request_id}`
+- **取消**：`PUT .../requests/{request_id}/cancel`
+- **Webhook**：提交时加 `?fal_webhook=<url>`
+- **计费**：按输出计费，从预付余额扣除；**服务端错误与排队时间不计费**
+- **上传输入文件**：fal CDN（见 https://fal.ai/docs/documentation/model-apis/fal-cdn）
+- **权威 schema**：`https://fal.ai/models/<endpoint-id>/llms.txt`（实时生成，不会与线上端点漂移）；OpenAPI：`https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=<endpoint-id>`
+
+## 2. 能力清单
+
+| 能力 | endpoint id |
+|---|---|
+| 文生图 | `bytedance/seedream/v5/pro/text-to-image` |
+| 图像编辑 / 多参考图（最多 10 张） | `bytedance/seedream/v5/pro/edit` |
+
+> Fal 上 Seedream 5.0 Pro **没有独立的图层拆分端点**；`edit` 的模型简介提到具备 layer separation 能力，但输入 schema 中没有对应开关。需要图层拆分请走火山引擎官方或 APIMart / KIE。
+
+## 3. 请求参数
+
+### 3.1 `bytedance/seedream/v5/pro/text-to-image`
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `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 }`（单边 ≤ 14142）。总像素须在 `[1048576 (1024×1024), 4194304 (2048×2048)]`，宽高比在 `[1/16, 16]` |
+| `num_images` | integer | 可选 | `1` | 1–6，独立跑多次生成 |
+| `output_format` | string | 可选 | `jpeg` | `jpeg` / `png` |
+| `sync_mode` | boolean | 可选 | `false` | `true` 时结果以 data URI 返回，且不进入请求历史 |
+| `enable_safety_checker` | boolean | 可选 | `true` | 关闭需账号授权；未授权的请求一律走安全检查 |
+
+### 3.2 `bytedance/seedream/v5/pro/edit`
+
+字段同上，另加：
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `image_urls` | string[] | 必填 | 参考图 URL 列表。**最多 10 张；超出时只取最后 10 张**（不报错，静默截断） |
+
+## 4. 响应结构
+
+```json
+{ "images": [ { "url": "https://v3b.fal.media/files/b/.../xxx.png" } ] }
+```
+
+`images` 为必返回字段，元素为 `Image` 对象（含 `url`，通常还有宽高、content_type）。
+
+## 5. 价格
+
+来源：两个端点各自的 `llms.txt`（2026-08-30 重新核对），Fal 标注为 tentative pricing。
+
+**文生图**
+
+| 输出图面积 | 单价 |
+|---|---|
+| ≤ 1536×1536 | **$0.0675/张** |
+| 1536×1536 ~ 2048×2048 | **$0.135/张** |
+
+**图像编辑**：在上面基础上叠加输入图费用——**第 1 张输入图免费，之后每张 +$0.0045**，且这笔加价是**按每张输出图**计算：
+`单价 = 基础价 + $0.0045 × 额外输入图数量`（每张输出图）。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。本端点无这两个字段。
+- `output_format`、`sync_mode` 按项目约定不展示、不请求。
+- 画布比例映射：智能比例走 `auto_1K` / `auto_2K`；固定比例应换算成满足面积与宽高比约束的 `{width, height}`，不要依赖 `square_hd` 这类语义枚举（覆盖不到 21:9 等比例）。
+- SDK 固定比例覆盖 `1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9`；另提供显式 `1MP` 请求档，把所选比例换算为约 1024²、16 对齐的对象。默认仍是 0.1.5 的 `2K`，不会改变既有宿主。
+- `image_urls` 超过 10 张会被**静默截断**为最后 10 张，UI 层需自行限制数量，否则用户以为传上去了。
+- 输入图加价必须按三个运行场景中的最大有效图片数量估算：生成提交的 `uploadedFilePaths`、画布的 `images` 与对话面板的 `uploadedImages`；空字符串和无效项不计数，较短的旧路径数组不能压住较新的完整图片列表。
+- Fal 定价标注为 tentative，接入前应重新读一次 `llms.txt`。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文生图模型页 | https://fal.ai/models/bytedance/seedream/v5/pro/text-to-image | 否 |
+| 文生图 schema + 价格（权威） | https://fal.ai/models/bytedance/seedream/v5/pro/text-to-image/llms.txt | 否 |
+| 文生图 OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=bytedance/seedream/v5/pro/text-to-image | 否 |
+| 编辑模型页 | https://fal.ai/models/bytedance/seedream/v5/pro/edit | 否 |
+| 编辑 schema + 价格（权威） | https://fal.ai/models/bytedance/seedream/v5/pro/edit/llms.txt | 否 |
+| 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
+| 鉴权 | https://fal.ai/docs/documentation/setting-up/authentication | 否 |
+| 计费说明 | https://fal.ai/docs/documentation/model-apis/pricing | 否 |
+| API Key 创建 | https://fal.ai/dashboard/keys | **是** |

package/docs/model-adaptation/Seedream-5.0-Pro/Seedream-5.0-Pro_KIE.md

@@ -0,0 +1,141 @@
+# Seedream 5.0 Pro · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-22 |
+| 模态 | 图片 |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID | `seedream/5-pro-text-to-image`、`seedream/5-pro-image-to-image`、`seedream/5-pro-layer-decomposition` |
+| 接口形态 | **异步任务**：统一 `createTask` 提交，统一 `recordInfo` 查询 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录（定价页可搜索） |
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.kie.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`（在 https://kie.ai/api-key 获取）
+- **提交**：`POST /api/v1/jobs/createTask`，请求体 `{ "model": ..., "callBackUrl": ..., "input": { ... } }`
+- **查询**：`GET /api/v1/jobs/recordInfo?taskId=<taskId>`
+- **回调**：生产环境建议用 `callBackUrl` 而非轮询；回调签名校验见 Webhook 校验指南
+- **账户积分**：`GET /api/v1/chat/credit`
+- **下载链接**：`GET /api/v1/common/download-url`
+
+任务查询返回（`data` 对象）：
+
+| 字段 | 说明 |
+|---|---|
+| `taskId` | 任务 ID |
+| `model` | 本次使用的模型 |
+| `state` | `waiting` / `queuing` / `generating` / `success` / `fail` |
+| `param` | 创建任务时的原始请求参数（**JSON 字符串**） |
+| `resultJson` | 结果（**JSON 字符串，需再 parse**）。图像/视频为 `{resultUrls: []}`；文本型为 `{resultObject: {}}` |
+| `failCode` / `failMsg` | 失败码与失败信息，成功时为空字符串 |
+| `costTime` | 处理耗时（毫秒） |
+| `completeTime` / `createTime` / `updateTime` | Unix 毫秒时间戳 |
+| `creditsConsumed` | 本次消耗积分 |
+
+> `progress` 字段只有 sora2 / sora2 pro 会返回，Seedream 不返回进度。
+
+## 2. 能力清单（KIE 把每种能力拆成独立 model，不能漏）
+
+| 能力 | model |
+|---|---|
+| 文生图 | `seedream/5-pro-text-to-image` |
+| 图片编辑（1–10 张参考图） | `seedream/5-pro-image-to-image` |
+| 图层拆分 | `seedream/5-pro-layer-decomposition` |
+
+## 3. 请求参数
+
+### 3.1 `seedream/5-pro-text-to-image`
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | 必填 | — | 3–5000 字符 |
+| `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` = 1K，`high` = 2K |
+| `input.output_format` | string | 可选 | `png` | `png` / `jpeg` |
+| `input.nsfw_checker` | boolean | 可选 | `false` | 设为 `false` 关闭内容过滤，结果由模型直接返回；平台声明不保证全部过滤 |
+
+### 3.2 `seedream/5-pro-image-to-image`
+
+同上，另加：
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `input.image_urls` | array | 必填 | **最多 10 张**。传上传后的文件 URL（不是文件内容）。支持 image/jpeg、image/png、image/webp；单张 ≤ 30 MB |
+
+`prompt` 为 3–5000 字符；`quality` 同为 `basic`(1K) / `high`(2K)。
+
+### 3.3 `seedream/5-pro-layer-decomposition`
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.image_url` | string | 必填 | — | **单张**源图。支持 PNG、JPEG、WebP、BMP、TIFF、GIF；**不支持 HEIC、HEIF**；≤ 30 MB；总像素 262,144–36,000,000；宽高比 1:16–16:1 |
+| `input.prompt` | string | 可选 | — | 0–5000 字符。不传时模型自动识别主要元素；支持 `<bbox>x1 y1 x2 y2</bbox>` 精确指定，推荐 **0–1000 归一化坐标** |
+| `input.size` | string | 可选 | `auto` | `auto` / `1K` / `1.5K` / `2K`。底图保持输入图宽高比，各图层保持对应元素在原图中的宽高比 |
+| `input.output_format` | string | 可选 | **`jpeg`** | 仅控制**底图**格式；所有拆分图层固定输出 PNG |
+
+> 注意：图层拆分端点的 `output_format` 默认是 `jpeg`，与另两个端点（默认 `png`）不同。
+
+## 4. 响应结构
+
+**普通生成**：`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`。
+
+**图层拆分**：`resultJson` 结构不同，**不能按普通单图 URL 解析**：
+
+```json
+{
+  "resultObject": {
+    "layers_data": [
+      { "z_index": 0, "size": "1080x1080", "output_format": "jpeg", "url": "https://.../xxx.jpeg" },
+      { "z_index": 1, "size": "1179x245", "output_format": "png",
+        "bounding_box": { "absolute": [202,63,872,202], "normalized": [187,58,806,186] },
+        "name": "Seedream标题文字",
+        "description": "提取黄色的Seedream标题文字，只保留文字本体……",
+        "url": "https://.../yyy.png" }
+    ]
+  },
+  "resultUrls": ["https://.../xxx.jpeg", "https://.../yyy.png", "..."]
+}
+```
+
+`z_index=0` 为底图；图层按 `z_index` 从小到大叠放；`normalized` 为 0–1000 归一化坐标。
+
+## 5. 价格
+
+来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `seedream`；1 Credit = $0.005）。
+
+| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 |
+|---|---|---|---|
+| 文生图 1K | 7 /张 | **$0.035/张** | $0.045 |
+| 文生图 2K | 14 /张 | **$0.07/张** | $0.09 |
+| 图片编辑 1K | 7 /张 | **$0.035/张** | $0.045 |
+| 图片编辑 2K | 14 /张 | **$0.07/张** | $0.09 |
+| 图层拆分 1K | 7 /张 | **$0.035/张** | $0.0675 |
+| 图层拆分 1.5K | 7 /张 | **$0.035/张** | $0.0675 |
+| 图层拆分 2K | 14 /张 | **$0.07/张** | $0.135 |
+| 输入图（首张免费） | 0.5 /张 | **$0.0025/张** | $0.003 |
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。本接口无这两个字段。
+- `output_format` 默认不显示且不请求；注意三个端点默认值不一致。
+- KIE 按能力拆 model，适配时应在同一个「模型」下按有无参考图/是否图层拆分路由到三个 model ID。
+- `resultJson` 是 JSON 字符串，必须二次 parse；图层拆分要读 `resultObject.layers_data` 而不是只取 `resultUrls[0]`。
+- `nsfw_checker` 默认 `false`（即不过滤），如需内容安全应显式打开。
+- KIE 的 `quality` 只有 `basic`(1K) / `high`(2K)，**没有 1.5K 档**；1.5K 只在图层拆分的 `size` 中出现。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Seedream 5.0 Pro 文生图 | https://docs.kie.ai/cn/market/seedream/5-pro-text-to-image | 否 |
+| Seedream 5.0 Pro 图片编辑 | https://docs.kie.ai/cn/market/seedream/5-pro-image-to-image | 否 |
+| Seedream 5.0 Pro 图层分离 | https://docs.kie.ai/41313512e0（英文路径：https://docs.kie.ai/market/seedream/5-pro-layer-decomposition） | 否 |
+| 获取任务详情（统一轮询协议） | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门（Base URL / 鉴权 / 积分） | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| Webhook 校验指南 | https://docs.kie.ai/cn/common-api/webhook-verification | 否 |
+| 文件上传（获取可用的 image_urls） | https://docs.kie.ai/cn/file-upload-api/upload-file-url | 否 |
+| 定价页（搜 `seedream`） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |
+| 文档总索引 | https://docs.kie.ai/llms.txt | 否 |

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

@@ -0,0 +1,137 @@
+# Seedream 5.0 Pro · 火山引擎（火山方舟，官方）
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 图片 |
+| 供应商 | 火山引擎 · 火山方舟（Ark），模型原厂官方接口 |
+| 平台模型 ID | `doubao-seedream-5-0-pro-260628`（也可用推理接入点 Endpoint ID 调用） |
+| 接口形态 | **同步**（一次 POST 直接返回图片），可选流式（本模型不支持流式） |
+| 文档可见性 | 公开，无需登录即可阅读；调用需 API Key |
+| 价格可见性 | 公开，无需登录 |
+| 官方文档最后更新 | 2026-08-12（文档站 `UpdatedTime`） |
+
+## 1. 接入协议
+
+- **接口**：`POST https://ark.cn-beijing.volces.com/api/v3/images/generations`
+- **鉴权**：`Authorization: Bearer $ARK_API_KEY`（长效 API Key，在方舟控制台「API Key 管理」获取）
+- **调用方式**：同步返回，无任务轮询。请求体 `Content-Type: application/json`
+- **结果时效**：`response_format=url` 时返回的图片链接 **24 小时内有效**，必须及时转存
+
+最小请求：
+
+```bash
+curl https://ark.cn-beijing.volces.com/api/v3/images/generations \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $ARK_API_KEY" \
+  -d '{
+    "model": "doubao-seedream-5-0-pro-260628",
+    "prompt": "赛博朋克风格的城市夜景，霓虹灯反射在湿润街道上",
+    "size": "2K"
+  }'
+```
+
+## 2. 能力清单（官方明确列出，勿遗漏）
+
+| 能力 | 说明 | 触发方式 |
+|---|---|---|
+| 文生图 | 纯提示词生成单张图 | 不传 `image` |
+| 单图生图 | 1 张参考图 + 提示词 | `image` 传 1 张 |
+| 多图生图 | 2–10 张参考图 + 提示词，生成单张 | `image` 传数组，2–10 张 |
+| 交互编辑 | 提示词中用坐标 / 框选 / 箭头指定编辑位置 | 在 `prompt` 中写 `<point>`/`<bbox>` 或上传带手绘标记的图 |
+| 图层拆分 | 单图拆成 1 张底图 + 最多 16 个透明 PNG 图层，返回层序/名称/描述/边界框 | `layer_decomposition: true` + 恰好 1 张 `image` |
+
+**Pro 明确不支持**：组图生成（`sequential_image_generation`）、联网搜索（`tools`）、流式输出（`stream`）。这三项只属于 Seedream 5.0 lite / 4.5 / 4.0。
+
+## 3. 请求参数（Body）
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必选 | — | `doubao-seedream-5-0-pro-260628`，或推理接入点 Endpoint ID |
+| `prompt` | string | 图片生成场景必选；图层拆分场景可选 | — | 生成描述或拆分意图。支持中英文，Pro 额外支持俄/阿/菲/泰/土/韩/马来/西/葡/印尼/法/德/越/日语。建议中文 ≤ 300 字、英文 ≤ 600 词。图层拆分不传时模型自动识别全部主要元素 |
+| `image` | string / string[] | 图片生成可选；图层拆分必选 | — | 参考图，URL 或 `data:image/<格式小写>;base64,<编码>`。Pro **最多 10 张** |
+| `layer_decomposition` | boolean | 可选 | `false` | 图层拆分开关。`true` 时仅支持单张输入图；任一图层失败则整体报错，不支持部分成功 |
+| `size` | string | 可选 | 生成场景 `2K`；图层拆分场景 `auto` | 见下方「size 取值」 |
+| `optimize_prompt_options` | object | 可选 | `{"mode":"standard"}` | `mode`：`standard`（质量优先）/ `fast`（低时延） |
+| `output_format` | string | 可选 | `jpeg` | `png` / `jpeg`。图层拆分时仅控制**底图**格式，图层恒为 PNG |
+| `background` | string | 可选 | `opaque` | `opaque` / `transparent`。透明背景仅支持图生图，且只能传 **1 张本身带透明通道**的图；此时输出默认 png，若同时设 `output_format: jpeg` 会报错 |
+| `response_format` | string | 可选 | `url` | `url`（24 小时有效）/ `b64_json` |
+| `watermark` | boolean | 可选 | **`true`** | 是否在右下角加「AI 生成」水印。注意官方默认是 `true`，接入时通常要显式传 `false` |
+| `sequential_image_generation` | string | — | — | **Pro 不支持**，仅 lite / 4.5 / 4.0 |
+| `sequential_image_generation_options` | object | — | — | **Pro 不支持** |
+| `stream` | boolean | — | — | **Pro 不支持** |
+| `tools` | object[] | — | — | **Pro 不支持**（`web_search` 仅 lite 支持） |
+
+### size 取值
+
+**图片生成场景**，两种写法不可混用：
+
+- 方式 1（推荐）：分辨率档位 `1K` / `1.5K` / `2K`，默认 `2K`；宽高比在 prompt 中用自然语言描述，由模型判断。**`1.5K` 与 `1K` 同价且效果更好**。
+- 方式 2：精确像素 `宽x高`。总像素范围 `[921600 (1280×720), 4624220 (2048×2048×1.1025)]`，宽高比范围 `[1/16, 16]`；两个条件需同时满足。有效示例 `2048x1024`；无效示例 `512x512`（总像素不足）。
+
+档位 → 常见宽高像素映射（官方给出的参考值，非穷举）：
+
+| 分辨率 | 1:1 | 4:3 | 3:4 | 16:9 | 9:16 | 3:2 | 2:3 | 21:9 |
+|---|---|---|---|---|---|---|---|---|
+| 1K | 1024×1024 | 1152×864 | 864×1152 | 1424×800 | 800×1424 | 1248×832 | 832×1248 | 1568×672 |
+| 1.5K | 1536×1536 | 1792×1344 | 1344×1792 | 2048×1152 | 1152×2048 | 1872×1248 | 1248×1872 | 2352×1008 |
+| 2K | 2048×2048 | 2368×1776 | 1776×2368 | 2816×1584 | 1584×2816 | 2496×1664 | 1664×2496 | 3136×1344 |
+
+**图层拆分场景**：只支持档位写法，可选 `1K` / `1.5K` / `2K` / `auto`（默认 `auto`）。底图分辨率与 `size` 一致且保持原图宽高比；各图层分辨率接近 `size`，各自保持在原图中的宽高比。`auto` 规则：原始尺寸落在 `[921600, 4624220]` 内按原尺寸输出；小于 1K 按 1K；大于 2K 按 2K。
+
+### 输入图片限制
+
+- 图片生成场景：格式 jpeg/png/webp/bmp/tiff/gif/heic/heif；宽高比 `[1/16, 16]`；单边 > 14 px；≤ 30 MB；总像素 `[196, 36000000]`
+- 图层拆分场景：格式仅 png/jpeg；宽高比 `[1/16, 16]`；≤ 30 MB；总像素 `[262144 (512×512), 36000000]`
+
+## 4. 响应结构
+
+顶层：`created`（Unix 秒）、`model`、`data[]`、`error`、`tools[]`、`usage`。
+
+`data[]` 公共字段：`url`（`response_format=url` 时）、`b64_json`（`response_format=b64_json` 时）、`size`（`<宽>x<高>`）、`output_format`。
+
+**图层拆分场景** `data[]` 额外返回：
+
+| 字段 | 说明 |
+|---|---|
+| `z_index` | 叠放顺序。底图固定 `0`，图层从 `1` 递增，越大越靠上 |
+| `name` | 模型自动生成的图层名称/标签 |
+| `description` | 图层的语义描述（颜色、状态、材质等） |
+| `bounding_box.absolute` | `[left, top, right, bottom]` 绝对像素坐标，底图左上角为 `(0,0)`。还原：`x=left`、`y=top`、`w=right-left`、`h=bottom-top` |
+| `bounding_box.normalized` | 同格式，归一化到 `[0, 1000]` 整数。还原到 `W×H` 画布：`x=left/1000×W`、`w=(right-left)/1000×W`，依此类推 |
+
+底图覆盖整张画布，不返回 `bounding_box`。多图层按 `z_index` 从小到大叠放。
+
+## 5. 价格（官方，人民币）
+
+来源：火山方舟「模型价格」文档（`DocumentID=1544106`，更新于 2026-08-20）。
+
+| 模型 | 输入图 | 输出 |
+|---|---|---|
+| `doubao-seedream-5-0-pro` | 首张免费，第 2 张起 **0.02 元/张** | **单图生成**：≤ 261 万像素（1.5K 及以下）**0.30 元/张**；> 261 万像素（1.5K 以上）**0.60 元/张**<br>**图层拆分**：≤ 261 万像素 **0.15 元/张**；> 261 万像素 **0.30 元/张** |
+
+计费提醒（官方原文）：图层拆分场景，同一次请求输出的图层可能分别落在不同像素档位，**按每个图层实际像素档位单独计费**。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**的参数：随机种子 `seed`、负面提示词。官方本接口本身也没有 `seed` / 负面提示词字段。
+- `watermark` 官方默认 `true`，与本项目预期相反，**必须显式传 `false`**。
+- `output_format` 按项目约定默认不显示、不请求。
+- 普通生成与图层拆分的返回结构不同（图层拆分返回一组图 + 层信息），不能按单图 URL 直接解析，需作为独立能力分支处理。
+- 图层拆分在提交前无法知道模型最终会输出多少层，且各层可能落入不同像素档位；价格面板不能把“单层价格”冒充确定总价，图层模式应显示为暂不可估算，并在说明中保留 **0.15 / 0.30 元每输出图层**的官方单位价。
+- 价格计算依赖参考图数量时，必须同时识别生成提交、画布和对话/工具面板的三套媒体字段，避免空的本地路径数组遮蔽实时图片数组。
+- Pro 为单图模型，不要下发 `n`、`sequential_image_generation`、`stream`、`tools`。
+- 官方限流：模型列表文档标注 Pro 的限流值为 500（单位见官方页面）。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 图片生成 API（参数、能力、响应全量） | https://console.volcengine.com/ark/region:cn-beijing/docs/82379/1541523?lang=zh | 否（正文公开；调用需 API Key） |
+| 同一文档的公开镜像 | https://www.volcengine.com/docs/82379/1541523 | 否 |
+| 文档正文 JSON（含 Markdown 全文与更新时间） | https://docs.volcengine.com/api/doc/getDocDetail?LibraryID=82379&DocumentID=1541523&type=online | 否 |
+| 模型价格 | https://www.volcengine.com/docs/82379/1544106 | 否 |
+| 模型列表（Model ID、限流、支持能力） | https://www.volcengine.com/docs/82379/1330310 | 否 |
+| Base URL 及鉴权 | https://docs.volcengine.com/docs/82379/1298459 | 否 |
+| Seedream 4.0–5.0 提示词指南 | https://www.volcengine.com/docs/82379/1829186 | 否 |
+| API Key 管理 | https://console.volcengine.com/ark/region:cn-beijing/apiKey | **是** |

package/docs/model-adaptation/SenseVoiceSmall/SenseVoiceSmall_/347/241/205/345/237/272/346/265/201/345/212/250.md

@@ -0,0 +1,69 @@
+# SenseVoiceSmall · 硅基流动
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-31 |
+| 模态 | ASR（同步文件转写） |
+| 供应商 | SiliconFlow / SiliconCloud |
+| 平台模型 ID | `FunAudioLLM/SenseVoiceSmall` |
+| 当前公开价格 | **免费** |
+| 免费前提 | 账号实名认证；固定 Rate Limits，精确数值未公开 |
+| 文档/价格 | 公开无需登录；Key/实名/用量需登录 |
+
+## 1. 端点与鉴权
+
+```text
+POST https://api.siliconflow.cn/v1/audio/transcriptions
+Authorization: Bearer <SILICONFLOW_API_KEY>
+Content-Type: multipart/form-data
+```
+
+请求仅需两个官方公开字段：
+
+```text
+file=<binary audio file>
+model=FunAudioLLM/SenseVoiceSmall
+```
+
+`file` 必须不超过 1 小时、50 MB。官方 cURL 以 MP3 为示例，但转写页未公开完整文件
+格式白名单。公开协议没有 `language/prompt/response_format`、热词、说话人、情感或音频事件
+参数，也没有 WebSocket/SSE 实时接口。
+
+## 2. 响应契约
+
+```json
+{
+  "text": "<string>"
+}
+```
+
+响应头包含 `x-siliconcloud-trace-id`。虽然 SenseVoice 开源上游还有多语种、情感与音频事件能力，
+硅基流动当前转写 API 只声明 `text`。SDK 文档与类型不得保证端点会返回上游额外标签。
+
+## 3. 价格、账号与限流
+
+- 2026-08-31 公开价格页的语音模型栏对 `FunAudioLLM/SenseVoiceSmall` 标注“免费”。
+- 这是免费模型计划，不是一次性赠送金；官方说明账单中调用消耗为 0。
+- 全部免费模型要求实名认证。限流为固定值，但公开 Rate Limits 页未给本模型的精确
+  RPM/RPD/音频时长额度；以登录后实际账号页为准。
+- 官方转写页明确保留模型上下线和服务能力调整的可能；价格/可用性需在发布前复核。
+
+## 4. 错误与适配要点
+
+官方错误体可为 `{code,message,data}` JSON，也可为纯文本。常见状态为 400/401/403/429/
+500/503/504；403 可与实名、模型权限或余额有关。SDK 的 `provider_http_error` 诊断文本保留
+HTTP status、可用的 `code/message/data`、文本 fallback 和脱敏追踪 ID；
+当前通用 `AiRuntimeError` 不提供结构化供应商错误 metadata。
+
+Say-It/SDK 接入是简单 Bearer + multipart HTTP，但不得透传硅基流动未公开的 OpenAI ASR
+扩展参数。中国大陆使用 `api.siliconflow.cn`；本轮未发起真实请求，实际账号限流未实测。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| ASR API、模型 ID、输入限制与响应 | https://docs.siliconflow.cn/docs/api/audio-transcriptions-post | 否 |
+| 当前价格 | https://siliconflow.cn/pricing | 否 |
+| 免费模型/实名/Rate Limits 规则 | https://docs.siliconflow.cn/cn/userguide/rate-limits/rate-limit-and-upgradation | 否 |
+| 错误处理 | https://docs.siliconflow.cn/cn/faqs/error-code | 否 |
+| API Key | https://cloud.siliconflow.cn/account/ak | **是** |