@henjicc/ai-sdk 0.2.8 → 0.3.0

package/docs/model-adaptation/Bria-/345/210/233/346/204/217/346/224/276/345/244/247/Bria-/345/210/233/346/204/217/346/224/276/345/244/247_Fal.md

@@ -1,31 +1,31 @@
-# Bria 创意放大（Fal）
-
-## 契约
-
-| 项目 | 内容 |
-|---|---|
-| endpoint ID | `bria/upscale/creative` |
-| 输入 | `image_url`；Fal 有示例默认图，应用仍严格要求用户提供 1 张源图 |
-| 输出 | `image: Image`，约 2×，最高 10MP |
-| 参数 | `preserve_alpha`，默认 true |
-| 隐藏字段 | `seed`、`sync_mode` |
-| 价格 | `$0.04/张` |
-| 资料核查 | 2026-08-29；公开，无需登录 |
-
-## 队列与适配
-
-使用 `Authorization: Key <FAL_KEY>` 调用 `https://queue.fal.run`，复用标准 Fal
-`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED` 队列、取消和 URL 提取。canonical ID 为
-`bria-creative-upscale`，应用模型 ID 为 `fal-ai-bria-creative-upscale`。
-
-画布按固定 2× 预估尺寸，在上传前阻止超过 10MP 的输出；透明源图允许提交并默认保留 alpha。该模型属于
-创意增强，可能生成新纹理，界面不使用“无损”措辞。已完成端点、请求、固定价、alpha 和输出上限的离线测试；
-未执行真实付费生成。
-
-## 一手资料
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| API 文档 | https://fal.ai/models/bria/upscale/creative/api | 否 |
-| OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=bria/upscale/creative | 否 |
-| API Key | https://fal.ai/dashboard/keys | 是 |
+# Bria 创意放大（Fal）
+
+## 契约
+
+| 项目 | 内容 |
+|---|---|
+| endpoint ID | `bria/upscale/creative` |
+| 输入 | `image_url`；Fal 有示例默认图，应用仍严格要求用户提供 1 张源图 |
+| 输出 | `image: Image`，约 2×，最高 10MP |
+| 参数 | `preserve_alpha`，默认 true |
+| 隐藏字段 | `seed`、`sync_mode` |
+| 价格 | `$0.04/张` |
+| 资料核查 | 2026-08-29；公开，无需登录 |
+
+## 队列与适配
+
+使用 `Authorization: Key <FAL_KEY>` 调用 `https://queue.fal.run`，复用标准 Fal
+`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED` 队列、取消和 URL 提取。canonical ID 为
+`bria-creative-upscale`，应用模型 ID 为 `fal-ai-bria-creative-upscale`。
+
+画布按固定 2× 预估尺寸，在上传前阻止超过 10MP 的输出；透明源图允许提交并默认保留 alpha。该模型属于
+创意增强，可能生成新纹理，界面不使用“无损”措辞。已完成端点、请求、固定价、alpha 和输出上限的离线测试；
+未执行真实付费生成。
+
+## 一手资料
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| API 文档 | https://fal.ai/models/bria/upscale/creative/api | 否 |
+| OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=bria/upscale/creative | 否 |
+| API Key | https://fal.ai/dashboard/keys | 是 |

package/docs/model-adaptation/ControlLight/ControlLight_Fal.md

@@ -1,85 +1,85 @@
-# ControlLight（Fal）适配资料
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-29 |
-| 平台 | Fal |
-| 展示名 | ControlLight |
-| API endpoint ID | `fal-ai/control-light` |
-| 模态 | 单图输入 → 暗光增强图片 |
-| SDK 入口 | `@henjicc/ai-sdk/tool-models/fal/control-light` |
-| 工具包 | `@henjicc/ai-sdk/tool-packs/fal-image-utility-tools` |
-| 价格 | `$0.03 / megapixel` |
-| 登录状态 | 模型页、`llms.txt` 与 OpenAPI 公开；真实调用需要 Fal Key |
-
-## 1. 能力与产品边界
-
-ControlLight 是基于 FLUX.2 [klein] 9B 的 LoRA，用于抬升暗光曝光并恢复可见细节。它与“重新设计光照方向/风格”不同：核心可见控件应是 `lighting_level` 强度，产品名建议使用“暗光增强”或“低光修复”，不宣称为物理补光。
-
-## 2. 接口与队列契约
-
-- 鉴权：`Authorization: Key <FAL_KEY>`
-- 直连：`POST https://fal.run/fal-ai/control-light`
-- 队列提交：`POST https://queue.fal.run/fal-ai/control-light`
-- 状态：`GET https://queue.fal.run/fal-ai/control-light/requests/{request_id}/status`
-- 结果：`GET https://queue.fal.run/fal-ai/control-light/requests/{request_id}`
-- 取消：`PUT https://queue.fal.run/fal-ai/control-light/requests/{request_id}/cancel`
-- 结果路径：`images[].url`；`images` 必填，`seed` 在 OpenAPI 中也标为必填
-
-队列状态仅有 `IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`，`status` 和 `request_id` 必填，日志、指标、队列位置和各 URL 可选。`COMPLETED` 后必须另取结果并校验媒体 URL；模型 OpenAPI 未定义新错误码、断线恢复或乱序规则，其余沿用 [Fal 供应商队列契约](../供应商/Fal.md#2-队列契约)。
-
-## 3. 请求字段
-
-| 字段 | 类型 | 必填 | 默认 / 范围 | 产品策略 |
-|---|---|---|---|---|
-| `image_url` | string | 是 | 官方未公布文件限制 | 恰好 1 张已有素材，由 Fal CDN 上传 |
-| `lighting_level` | number | 否 | `0.75`；`0..1` | 显示并发送；0 近似不处理，1 为训练范围内最强抬升 |
-| `prompt` | string | 否 | 官方内置一段保留身份、几何和自然颜色的恢复提示词 | 首版不展示、不发送，使用服务端当前默认 |
-| `num_inference_steps` | integer | 否 | `4`；`4..8` | 不展示、不发送 |
-| `guidance_scale` | number | 否 | `1`；`0..20` | 不展示、不发送 |
-| `enable_safety_checker` | boolean | 否 | `true` | 不展示、不发送，保持官方默认 |
-| `seed` | integer/null | 否 | 随机 | 不展示、不发送 |
-| `sync_mode` | boolean | 否 | `false` | 不展示、不发送，使用持久队列 |
-| `output_format` | enum | 否 | `png`；`jpeg` / `png` / `webp` | 按项目约定不展示、不发送 |
-
-## 4. 示例与响应契约冲突
-
-```json
-{
-  "image_url": "https://v3.fal.media/files/.../low-light.png",
-  "lighting_level": 0.75
-}
-```
-
-```json
-{
-  "images": [
-    {
-      "url": "https://v3b.fal.media/files/.../enhanced.png",
-      "width": 768,
-      "height": 1360,
-      "content_type": "image/png"
-    }
-  ],
-  "has_nsfw_concepts": [false]
-}
-```
-
-OpenAPI 把 `seed` 标为必填，但同一份官方 `llms.txt` 的字面响应示例缺少 `seed`。因此解析器只应将非空 `images[].url` 作为成功必要条件，`seed` 按可选元数据读取，不得因为缺少 seed 丢弃有效图片。
-
-## 5. 计价与未知项
-
-- 实时 `llms.txt` 标价 `$0.03 / megapixel`，但未字面说明是输入、输出还是处理像素。
-- 静态目录可保留 `$0.03/MP` 单位价；在未通过 billing event 校验前，不应把估算值表述成最终账单。
-- 官方未给输入图像尺寸/格式上限、输出尺寸算法、延迟 SLA 和结果保留期。
-- 真实验收需记录 0 / 0.75 / 1 三档对主体、噪点、高光溢出和计费的影响。
-
-## 6. 原始链接索引
-
-| 内容 | 链接 | 是否需登录 | 核查日期 |
-|---|---|---|---|
-| 模型页与当前价格 | https://fal.ai/models/fal-ai/control-light | 否 | 2026-08-29 |
-| 实时字段、范围、示例与价格 | https://fal.ai/models/fal-ai/control-light/llms.txt | 否 | 2026-08-29 |
-| OpenAPI（必填、响应与枚举） | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/control-light | 否 | 2026-08-29 |
-| Fal 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 | 2026-08-29 |
-| Fal 价格 API | https://fal.ai/docs/platform-apis/v1/models/pricing | 否（调用需 Key） | 2026-08-29 |
+# ControlLight（Fal）适配资料
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-29 |
+| 平台 | Fal |
+| 展示名 | ControlLight |
+| API endpoint ID | `fal-ai/control-light` |
+| 模态 | 单图输入 → 暗光增强图片 |
+| SDK 入口 | `@henjicc/ai-sdk/tool-models/fal/control-light` |
+| 工具包 | `@henjicc/ai-sdk/tool-packs/fal-image-utility-tools` |
+| 价格 | `$0.03 / megapixel` |
+| 登录状态 | 模型页、`llms.txt` 与 OpenAPI 公开；真实调用需要 Fal Key |
+
+## 1. 能力与产品边界
+
+ControlLight 是基于 FLUX.2 [klein] 9B 的 LoRA，用于抬升暗光曝光并恢复可见细节。它与“重新设计光照方向/风格”不同：核心可见控件应是 `lighting_level` 强度，产品名建议使用“暗光增强”或“低光修复”，不宣称为物理补光。
+
+## 2. 接口与队列契约
+
+- 鉴权：`Authorization: Key <FAL_KEY>`
+- 直连：`POST https://fal.run/fal-ai/control-light`
+- 队列提交：`POST https://queue.fal.run/fal-ai/control-light`
+- 状态：`GET https://queue.fal.run/fal-ai/control-light/requests/{request_id}/status`
+- 结果：`GET https://queue.fal.run/fal-ai/control-light/requests/{request_id}`
+- 取消：`PUT https://queue.fal.run/fal-ai/control-light/requests/{request_id}/cancel`
+- 结果路径：`images[].url`；`images` 必填，`seed` 在 OpenAPI 中也标为必填
+
+队列状态仅有 `IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`，`status` 和 `request_id` 必填，日志、指标、队列位置和各 URL 可选。`COMPLETED` 后必须另取结果并校验媒体 URL；模型 OpenAPI 未定义新错误码、断线恢复或乱序规则，其余沿用 [Fal 供应商队列契约](../供应商/Fal.md#2-队列契约)。
+
+## 3. 请求字段
+
+| 字段 | 类型 | 必填 | 默认 / 范围 | 产品策略 |
+|---|---|---|---|---|
+| `image_url` | string | 是 | 官方未公布文件限制 | 恰好 1 张已有素材，由 Fal CDN 上传 |
+| `lighting_level` | number | 否 | `0.75`；`0..1` | 显示并发送；0 近似不处理，1 为训练范围内最强抬升 |
+| `prompt` | string | 否 | 官方内置一段保留身份、几何和自然颜色的恢复提示词 | 首版不展示、不发送，使用服务端当前默认 |
+| `num_inference_steps` | integer | 否 | `4`；`4..8` | 不展示、不发送 |
+| `guidance_scale` | number | 否 | `1`；`0..20` | 不展示、不发送 |
+| `enable_safety_checker` | boolean | 否 | `true` | 不展示、不发送，保持官方默认 |
+| `seed` | integer/null | 否 | 随机 | 不展示、不发送 |
+| `sync_mode` | boolean | 否 | `false` | 不展示、不发送，使用持久队列 |
+| `output_format` | enum | 否 | `png`；`jpeg` / `png` / `webp` | 按项目约定不展示、不发送 |
+
+## 4. 示例与响应契约冲突
+
+```json
+{
+  "image_url": "https://v3.fal.media/files/.../low-light.png",
+  "lighting_level": 0.75
+}
+```
+
+```json
+{
+  "images": [
+    {
+      "url": "https://v3b.fal.media/files/.../enhanced.png",
+      "width": 768,
+      "height": 1360,
+      "content_type": "image/png"
+    }
+  ],
+  "has_nsfw_concepts": [false]
+}
+```
+
+OpenAPI 把 `seed` 标为必填，但同一份官方 `llms.txt` 的字面响应示例缺少 `seed`。因此解析器只应将非空 `images[].url` 作为成功必要条件，`seed` 按可选元数据读取，不得因为缺少 seed 丢弃有效图片。
+
+## 5. 计价与未知项
+
+- 实时 `llms.txt` 标价 `$0.03 / megapixel`，但未字面说明是输入、输出还是处理像素。
+- 静态目录可保留 `$0.03/MP` 单位价；在未通过 billing event 校验前，不应把估算值表述成最终账单。
+- 官方未给输入图像尺寸/格式上限、输出尺寸算法、延迟 SLA 和结果保留期。
+- 真实验收需记录 0 / 0.75 / 1 三档对主体、噪点、高光溢出和计费的影响。
+
+## 6. 原始链接索引
+
+| 内容 | 链接 | 是否需登录 | 核查日期 |
+|---|---|---|---|
+| 模型页与当前价格 | https://fal.ai/models/fal-ai/control-light | 否 | 2026-08-29 |
+| 实时字段、范围、示例与价格 | https://fal.ai/models/fal-ai/control-light/llms.txt | 否 | 2026-08-29 |
+| OpenAPI（必填、响应与枚举） | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/control-light | 否 | 2026-08-29 |
+| Fal 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 | 2026-08-29 |
+| Fal 价格 API | https://fal.ai/docs/platform-apis/v1/models/pricing | 否（调用需 Key） | 2026-08-29 |

package/docs/model-adaptation/FLUX-2-/345/244/232/350/247/222/345/272/246/FLUX-2-/345/244/232/350/247/222/345/272/246_Fal.md

@@ -1,107 +1,107 @@
-# FLUX 2 多角度（Fal）适配资料
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-29 |
-| 平台 | Fal |
-| 展示名 | Flux 2 Lora Gallery / Multiple Angles |
-| API endpoint ID | `fal-ai/flux-2-lora-gallery/multiple-angles` |
-| 模态 | 图片数组输入 → 指定镜头角度的图片 |
-| SDK 入口 | `@henjicc/ai-sdk/tool-models/fal/flux-2-multiple-angles` |
-| 工具包 | `@henjicc/ai-sdk/tool-packs/fal-multi-angle-tools` |
-| 价格 | `$0.021 / processed megapixel` |
-| 登录状态 | 模型页、`llms.txt` 与 OpenAPI 公开；真实调用需要 Fal Key |
-
-> 模型用度数表达水平和垂直控制，但没有输出相机内参、外参或误差。产品可称“镜头角度”或“模型控制角”，不能称测量级姿态。
-
-## 1. 角度语义
-
-| 字段 | 官方语义 |
-|---|---|
-| `horizontal_angle` | `0°` 正面，`90°` 右侧，`180°` 背面，`270°` 左侧，`360°` 回到正面 |
-| `vertical_angle` | `0°` 平视，`30°` 高机位，`60°` 高角度俯拍 |
-| `zoom` | `0` 远景，`5` 中景，`10` 近景 |
-
-该端点没有请求 `prompt`：官方说明提示词由滑块数值自动组装。正式 UI 不应展示一个不会进入请求的提示词框。
-
-## 2. 接口与队列契约
-
-- 鉴权：`Authorization: Key <FAL_KEY>`
-- 直连：`POST https://fal.run/fal-ai/flux-2-lora-gallery/multiple-angles`
-- 队列提交：`POST https://queue.fal.run/fal-ai/flux-2-lora-gallery/multiple-angles`
-- 状态：`GET https://queue.fal.run/fal-ai/flux-2-lora-gallery/multiple-angles/requests/{request_id}/status`
-- 结果：`GET https://queue.fal.run/fal-ai/flux-2-lora-gallery/multiple-angles/requests/{request_id}`
-- 取消：`PUT https://queue.fal.run/fal-ai/flux-2-lora-gallery/multiple-angles/requests/{request_id}/cancel`
-- 结果路径：`images[].url`；OpenAPI 还把 `seed` 和服务端组装的 `prompt` 标为必填
-
-通用状态为 `IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`，`status` / `request_id` 必填。`COMPLETED` 后再获取结果并严格校验 `images[].url`；模型没有新增状态或错误码，其余复用 [Fal 供应商队列契约](../供应商/Fal.md#2-队列契约)。
-
-## 3. 请求字段
-
-| 字段 | 类型 | 必填 | 默认 / 范围 | 产品策略 |
-|---|---|---|---|---|
-| `image_urls` | `string[]` | 是 | **官方未给 `minItems` / `maxItems`** | 首版保守限制恰好 1 张；这是产品约束，不冒充官方限制；由 Fal CDN 上传 |
-| `horizontal_angle` | number | 否 | `0`；`0..360` | 显示并发送 |
-| `vertical_angle` | number | 否 | `0`；`0..60` | 显示并发送 |
-| `zoom` | number | 否 | `5`；`0..10` | 显示并发送 |
-| `image_size` | 对象 / enum / null | 否 | 枚举见下 | 首版按输入比例选约 1MP 标准档，显式发送，限制波动与费用 |
-| `guidance_scale` | number | 否 | `2.5`；`0..20` | 不展示、不发送 |
-| `num_inference_steps` | integer | 否 | `40`；`4..50` | 不展示、不发送 |
-| `acceleration` | enum | 否 | `regular`；`none` / `regular` | 不展示、不发送 |
-| `enable_safety_checker` | boolean | 否 | `true` | 不展示、不发送 |
-| `num_images` | integer | 否 | `1`；`1..4` | 首版一个目标角度对应一张，固定 1，不展示、不发送 |
-| `lora_scale` | number | 否 | `1`；`0..2` | 不展示、不发送 |
-| `seed` | integer/null | 否 | 随机 | 不展示、不发送 |
-| `sync_mode` | boolean | 否 | `false` | 不展示、不发送 |
-| `output_format` | enum | 否 | `png`；`png` / `jpeg` / `webp` | 按项目约定不展示、不发送 |
-
-`image_size` 可以是 `{width, height}`（宽高为正整数，单边最大 `14142`，子字段默认 `512`），或以下枚举：
-
-`square_hd` / `square` / `portrait_4_3` / `portrait_16_9` / `landscape_4_3` / `landscape_16_9`。
-
-## 4. 请求与响应示例
-
-```json
-{
-  "image_urls": ["https://v3.fal.media/files/.../object.png"],
-  "horizontal_angle": 90,
-  "vertical_angle": 30,
-  "zoom": 5,
-  "image_size": "square_hd"
-}
-```
-
-```json
-{
-  "images": [
-    { "url": "https://v3b.fal.media/files/.../angle.png" }
-  ],
-  "prompt": "<server-generated prompt>"
-}
-```
-
-OpenAPI 把 `seed` 标为必填，但同一份官方 `llms.txt` 的字面响应示例缺少 `seed`。解析器只应把非空 `images[].url` 当作成功必要条件，`seed` / `prompt` 按可选元数据处理。
-
-## 5. 多角度组与计价
-
-- 每个目标角度使用一次独立 Fal 请求，选择顺序在请求前固定，不从结果文件名推断。
-- 实时 `llms.txt` 标价 `$0.021 / processed megapixel`。首版固定约 1MP 时，单角度静态预算约 `$0.021`；4 角度约 `$0.084`。
-- “processed megapixel”的精确取整和输入/输出基准未在 `llms.txt` 展开，最终以 pricing API / billing event 为准。
-- 多次独立生成不保证身份、文字、不可见结构或背景一致；批次失败和按失败项重试策略应与现有多角度工具保持一致。
-
-## 6. 待真实验证
-
-- 人物、商品、建筑在 `0/90/180/270/360°` 的方位遵从和回环误差。
-- `vertical_angle` 只有正值，是否无法表达仰拍。
-- `zoom` 是改变景别还是同时改变主体几何。
-- 官方未给输入数量、文件限制、延迟 SLA 和一致性承诺。
-
-## 7. 原始链接索引
-
-| 内容 | 链接 | 是否需登录 | 核查日期 |
-|---|---|---|---|
-| 模型页与当前价格 | https://fal.ai/models/fal-ai/flux-2-lora-gallery/multiple-angles | 否 | 2026-08-29 |
-| 实时字段、范围、示例与价格 | https://fal.ai/models/fal-ai/flux-2-lora-gallery/multiple-angles/llms.txt | 否 | 2026-08-29 |
-| OpenAPI（完整尺寸枚举、范围、必填与响应） | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/flux-2-lora-gallery/multiple-angles | 否 | 2026-08-29 |
-| Fal 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 | 2026-08-29 |
-| Fal 价格 API | https://fal.ai/docs/platform-apis/v1/models/pricing | 否（调用需 Key） | 2026-08-29 |
+# FLUX 2 多角度（Fal）适配资料
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-29 |
+| 平台 | Fal |
+| 展示名 | Flux 2 Lora Gallery / Multiple Angles |
+| API endpoint ID | `fal-ai/flux-2-lora-gallery/multiple-angles` |
+| 模态 | 图片数组输入 → 指定镜头角度的图片 |
+| SDK 入口 | `@henjicc/ai-sdk/tool-models/fal/flux-2-multiple-angles` |
+| 工具包 | `@henjicc/ai-sdk/tool-packs/fal-multi-angle-tools` |
+| 价格 | `$0.021 / processed megapixel` |
+| 登录状态 | 模型页、`llms.txt` 与 OpenAPI 公开；真实调用需要 Fal Key |
+
+> 模型用度数表达水平和垂直控制，但没有输出相机内参、外参或误差。产品可称“镜头角度”或“模型控制角”，不能称测量级姿态。
+
+## 1. 角度语义
+
+| 字段 | 官方语义 |
+|---|---|
+| `horizontal_angle` | `0°` 正面，`90°` 右侧，`180°` 背面，`270°` 左侧，`360°` 回到正面 |
+| `vertical_angle` | `0°` 平视，`30°` 高机位，`60°` 高角度俯拍 |
+| `zoom` | `0` 远景，`5` 中景，`10` 近景 |
+
+该端点没有请求 `prompt`：官方说明提示词由滑块数值自动组装。正式 UI 不应展示一个不会进入请求的提示词框。
+
+## 2. 接口与队列契约
+
+- 鉴权：`Authorization: Key <FAL_KEY>`
+- 直连：`POST https://fal.run/fal-ai/flux-2-lora-gallery/multiple-angles`
+- 队列提交：`POST https://queue.fal.run/fal-ai/flux-2-lora-gallery/multiple-angles`
+- 状态：`GET https://queue.fal.run/fal-ai/flux-2-lora-gallery/multiple-angles/requests/{request_id}/status`
+- 结果：`GET https://queue.fal.run/fal-ai/flux-2-lora-gallery/multiple-angles/requests/{request_id}`
+- 取消：`PUT https://queue.fal.run/fal-ai/flux-2-lora-gallery/multiple-angles/requests/{request_id}/cancel`
+- 结果路径：`images[].url`；OpenAPI 还把 `seed` 和服务端组装的 `prompt` 标为必填
+
+通用状态为 `IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`，`status` / `request_id` 必填。`COMPLETED` 后再获取结果并严格校验 `images[].url`；模型没有新增状态或错误码，其余复用 [Fal 供应商队列契约](../供应商/Fal.md#2-队列契约)。
+
+## 3. 请求字段
+
+| 字段 | 类型 | 必填 | 默认 / 范围 | 产品策略 |
+|---|---|---|---|---|
+| `image_urls` | `string[]` | 是 | **官方未给 `minItems` / `maxItems`** | 首版保守限制恰好 1 张；这是产品约束，不冒充官方限制；由 Fal CDN 上传 |
+| `horizontal_angle` | number | 否 | `0`；`0..360` | 显示并发送 |
+| `vertical_angle` | number | 否 | `0`；`0..60` | 显示并发送 |
+| `zoom` | number | 否 | `5`；`0..10` | 显示并发送 |
+| `image_size` | 对象 / enum / null | 否 | 枚举见下 | 首版按输入比例选约 1MP 标准档，显式发送，限制波动与费用 |
+| `guidance_scale` | number | 否 | `2.5`；`0..20` | 不展示、不发送 |
+| `num_inference_steps` | integer | 否 | `40`；`4..50` | 不展示、不发送 |
+| `acceleration` | enum | 否 | `regular`；`none` / `regular` | 不展示、不发送 |
+| `enable_safety_checker` | boolean | 否 | `true` | 不展示、不发送 |
+| `num_images` | integer | 否 | `1`；`1..4` | 首版一个目标角度对应一张，固定 1，不展示、不发送 |
+| `lora_scale` | number | 否 | `1`；`0..2` | 不展示、不发送 |
+| `seed` | integer/null | 否 | 随机 | 不展示、不发送 |
+| `sync_mode` | boolean | 否 | `false` | 不展示、不发送 |
+| `output_format` | enum | 否 | `png`；`png` / `jpeg` / `webp` | 按项目约定不展示、不发送 |
+
+`image_size` 可以是 `{width, height}`（宽高为正整数，单边最大 `14142`，子字段默认 `512`），或以下枚举：
+
+`square_hd` / `square` / `portrait_4_3` / `portrait_16_9` / `landscape_4_3` / `landscape_16_9`。
+
+## 4. 请求与响应示例
+
+```json
+{
+  "image_urls": ["https://v3.fal.media/files/.../object.png"],
+  "horizontal_angle": 90,
+  "vertical_angle": 30,
+  "zoom": 5,
+  "image_size": "square_hd"
+}
+```
+
+```json
+{
+  "images": [
+    { "url": "https://v3b.fal.media/files/.../angle.png" }
+  ],
+  "prompt": "<server-generated prompt>"
+}
+```
+
+OpenAPI 把 `seed` 标为必填，但同一份官方 `llms.txt` 的字面响应示例缺少 `seed`。解析器只应把非空 `images[].url` 当作成功必要条件，`seed` / `prompt` 按可选元数据处理。
+
+## 5. 多角度组与计价
+
+- 每个目标角度使用一次独立 Fal 请求，选择顺序在请求前固定，不从结果文件名推断。
+- 实时 `llms.txt` 标价 `$0.021 / processed megapixel`。首版固定约 1MP 时，单角度静态预算约 `$0.021`；4 角度约 `$0.084`。
+- “processed megapixel”的精确取整和输入/输出基准未在 `llms.txt` 展开，最终以 pricing API / billing event 为准。
+- 多次独立生成不保证身份、文字、不可见结构或背景一致；批次失败和按失败项重试策略应与现有多角度工具保持一致。
+
+## 6. 待真实验证
+
+- 人物、商品、建筑在 `0/90/180/270/360°` 的方位遵从和回环误差。
+- `vertical_angle` 只有正值，是否无法表达仰拍。
+- `zoom` 是改变景别还是同时改变主体几何。
+- 官方未给输入数量、文件限制、延迟 SLA 和一致性承诺。
+
+## 7. 原始链接索引
+
+| 内容 | 链接 | 是否需登录 | 核查日期 |
+|---|---|---|---|
+| 模型页与当前价格 | https://fal.ai/models/fal-ai/flux-2-lora-gallery/multiple-angles | 否 | 2026-08-29 |
+| 实时字段、范围、示例与价格 | https://fal.ai/models/fal-ai/flux-2-lora-gallery/multiple-angles/llms.txt | 否 | 2026-08-29 |
+| OpenAPI（完整尺寸枚举、范围、必填与响应） | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/flux-2-lora-gallery/multiple-angles | 否 | 2026-08-29 |
+| Fal 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 | 2026-08-29 |
+| Fal 价格 API | https://fal.ai/docs/platform-apis/v1/models/pricing | 否（调用需 Key） | 2026-08-29 |

package/docs/model-adaptation/Finegrain-Eraser/Finegrain-Eraser_Fal.md

@@ -1,31 +1,31 @@
-# Finegrain Eraser (Mask) · Fal
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-28 |
-| SDK 模型 ID | `fal-finegrain-eraser`（可选工具模型，不进入默认 105 目录） |
-| Fal endpoint ID | `fal-ai/finegrain-eraser/mask` |
-| API 文档 | https://fal.ai/models/fal-ai/finegrain-eraser/mask/api |
-| 价格 | Express $0.04 / Standard $0.13 / Premium $0.22 |
-| 登录 | 文档与模型页无需登录；调用需要 Fal Key |
-
-## 协议与字段
-
-使用 Fal 队列公共协议，认证、提交、状态与结果读取同 [Fal 供应商文档](../供应商/Fal.md)。
-输出位于 `image.url`。
-
-| 字段 | 约束 | SDK 策略 |
-|---|---|---|
-| `image_url` | 必填，待处理原图 | `image-upload`，Fal CDN 自动上传 |
-| `mask_url` | 必填；白色区域擦除 | `image-upload`，Fal CDN 自动上传 |
-| `mode` | `express` / `standard` / `premium`，默认 `standard` | 保留为唯一可选参数 |
-| `seed` | 可选 | 项目约定隐藏且不请求 |
-
-Fal 另有 prompt/box 端点；本次严格适配 Photoshop 已启用的 mask 工具，不顺手扩张范围。
-统一画像从本模型 schema 派生为 `operation=image-edit`、`feature=erase`，执行仍走统一 Fal 生成内核。
-
-## 原始链接索引
-
-- https://fal.ai/models/fal-ai/finegrain-eraser/mask/api — mask endpoint、字段、结果与队列示例。
-- https://fal.ai/models/fal-ai/finegrain-eraser/mask — 当前三档价格。
-- https://fal.ai/docs/documentation/model-apis/inference/queue — Fal 队列公共协议。
+# Finegrain Eraser (Mask) · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| SDK 模型 ID | `fal-finegrain-eraser`（可选工具模型，不进入默认 105 目录） |
+| Fal endpoint ID | `fal-ai/finegrain-eraser/mask` |
+| API 文档 | https://fal.ai/models/fal-ai/finegrain-eraser/mask/api |
+| 价格 | Express $0.04 / Standard $0.13 / Premium $0.22 |
+| 登录 | 文档与模型页无需登录；调用需要 Fal Key |
+
+## 协议与字段
+
+使用 Fal 队列公共协议，认证、提交、状态与结果读取同 [Fal 供应商文档](../供应商/Fal.md)。
+输出位于 `image.url`。
+
+| 字段 | 约束 | SDK 策略 |
+|---|---|---|
+| `image_url` | 必填，待处理原图 | `image-upload`，Fal CDN 自动上传 |
+| `mask_url` | 必填；白色区域擦除 | `image-upload`，Fal CDN 自动上传 |
+| `mode` | `express` / `standard` / `premium`，默认 `standard` | 保留为唯一可选参数 |
+| `seed` | 可选 | 项目约定隐藏且不请求 |
+
+Fal 另有 prompt/box 端点；本次严格适配 Photoshop 已启用的 mask 工具，不顺手扩张范围。
+统一画像从本模型 schema 派生为 `operation=image-edit`、`feature=erase`，执行仍走统一 Fal 生成内核。
+
+## 原始链接索引
+
+- https://fal.ai/models/fal-ai/finegrain-eraser/mask/api — mask endpoint、字段、结果与队列示例。
+- https://fal.ai/models/fal-ai/finegrain-eraser/mask — 当前三档价格。
+- https://fal.ai/docs/documentation/model-apis/inference/queue — Fal 队列公共协议。

package/docs/model-adaptation/Flux-Pro-Erase/Flux-Pro-Erase_Fal.md

@@ -1,34 +1,34 @@
-# Flux Pro Erase · Fal
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-28 |
-| SDK 模型 ID | `fal-flux-pro-erase`（可选工具模型，不进入默认 105 目录） |
-| Fal endpoint ID | `fal-ai/flux-pro/v1/erase` |
-| API 文档 | https://fal.ai/models/fal-ai/flux-pro/v1/erase/api |
-| 价格 | 首个生成 MP $0.03，后续 $0.004/MP；参考图 $0.004/MP，至少按 3 MP |
-| 登录 | 文档与模型页无需登录；调用需要 Fal Key |
-
-## 协议与字段
-
-使用 Fal 队列公共协议：`POST https://queue.fal.run/<endpoint-id>`，随后查询服务端返回的
-`status_url`，状态为 `COMPLETED` 后读取 `response_url`。认证为
-`Authorization: Key <FAL_KEY>`。结果位于 `images[].url`。
-
-| 字段 | 约束 | SDK 策略 |
-|---|---|---|
-| `image_url` | 必填，待处理原图 | `image-upload`，本地媒体由 Fal CDN uploader 自动上传 |
-| `mask_url` | 必填，与原图同尺寸；白色擦除、黑色保留 | `image-upload`，自动上传 |
-| `dilate_pixels` | 整数，默认 10 | 固定发送 10，不增加宿主控件 |
-| `output_format` | `jpeg` / `png`，默认 `jpeg` | 按项目约定不显示、不发送 |
-| `sync_mode` | 同步返回 data URI | 不发送，统一使用可恢复队列 |
-
-静态价格展示采用最低约 `$0.042`（1 MP 生成 + 参考图最低 3 MP）；真实费用随输出像素增加。
-该模型按需发布为完整 generation pack，统一画像派生为 `operation=image-edit`、`feature=erase`；
-执行直接使用模块化生成客户端，不增加专用擦除执行内核。
-
-## 原始链接索引
-
-- https://fal.ai/models/fal-ai/flux-pro/v1/erase/api — endpoint、输入/输出 schema、队列调用。
-- https://fal.ai/models/fal-ai/flux-pro/v1/erase — 当前模型页价格与示例结果。
-- https://fal.ai/docs/documentation/model-apis/inference/queue — Fal 队列公共协议。
+# Flux Pro Erase · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| SDK 模型 ID | `fal-flux-pro-erase`（可选工具模型，不进入默认 105 目录） |
+| Fal endpoint ID | `fal-ai/flux-pro/v1/erase` |
+| API 文档 | https://fal.ai/models/fal-ai/flux-pro/v1/erase/api |
+| 价格 | 首个生成 MP $0.03，后续 $0.004/MP；参考图 $0.004/MP，至少按 3 MP |
+| 登录 | 文档与模型页无需登录；调用需要 Fal Key |
+
+## 协议与字段
+
+使用 Fal 队列公共协议：`POST https://queue.fal.run/<endpoint-id>`，随后查询服务端返回的
+`status_url`，状态为 `COMPLETED` 后读取 `response_url`。认证为
+`Authorization: Key <FAL_KEY>`。结果位于 `images[].url`。
+
+| 字段 | 约束 | SDK 策略 |
+|---|---|---|
+| `image_url` | 必填，待处理原图 | `image-upload`，本地媒体由 Fal CDN uploader 自动上传 |
+| `mask_url` | 必填，与原图同尺寸；白色擦除、黑色保留 | `image-upload`，自动上传 |
+| `dilate_pixels` | 整数，默认 10 | 固定发送 10，不增加宿主控件 |
+| `output_format` | `jpeg` / `png`，默认 `jpeg` | 按项目约定不显示、不发送 |
+| `sync_mode` | 同步返回 data URI | 不发送，统一使用可恢复队列 |
+
+静态价格展示采用最低约 `$0.042`（1 MP 生成 + 参考图最低 3 MP）；真实费用随输出像素增加。
+该模型按需发布为完整 generation pack，统一画像派生为 `operation=image-edit`、`feature=erase`；
+执行直接使用模块化生成客户端，不增加专用擦除执行内核。
+
+## 原始链接索引
+
+- https://fal.ai/models/fal-ai/flux-pro/v1/erase/api — endpoint、输入/输出 schema、队列调用。
+- https://fal.ai/models/fal-ai/flux-pro/v1/erase — 当前模型页价格与示例结果。
+- https://fal.ai/docs/documentation/model-apis/inference/queue — Fal 队列公共协议。