@henjicc/ai-sdk 0.9.0 → 0.10.0

package/docs/model-adaptation/Topaz-/351/200/217/346/230/216/345/233/276/346/224/276/345/244/247/Topaz-/351/200/217/346/230/216/345/233/276/346/224/276/345/244/247_Fal.md

@@ -1,34 +1,34 @@
-# Topaz 透明图放大（Fal）
-
-## 契约
-
-| 项目 | 内容 |
-|---|---|
-| endpoint ID | `topaz/upscale/image/transparent` |
-| 输入 | `image_url`，应用严格要求 1 张图片 |
-| 输出 | 固定 4×、固定 PNG，保留 alpha 通道；`image: File` |
-| 参数 | 无用户参数；官方 `output_format` 固定为 PNG，应用不重复下发 |
-| 价格 | 每开始 24 输出 MP `$0.08`，按实际固定 4× 输出尺寸估价 |
-| 资料核查 | 2026-08-29；公开，无需登录 |
-
-## 队列与鉴权
-
-使用 `Authorization: Key <FAL_KEY>` 调用 `https://queue.fal.run`：提交后轮询
-`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`，再从结果中的 `image.url` 获取输出；取消使用 endpoint 与
-`request_id` 组成的 `/cancel` 地址。复用 SDK 现有 Fal 上传、轮询、取消和结果解析，不新增协议分支。
-
-## 适配决策
-
-- canonical ID：`topaz-transparent-upscale`；应用模型 ID：`fal-ai-topaz-transparent-upscale`。
-- 该模型独立于 Topaz 主入口，避免把固定 4× 和透明语义伪装成普通倍率选项。
-- `pricing.mediaContext` 声明固定 4× 的输出面积换算，宿主共享价格层读取源图尺寸后按输出 MP 阶梯估价；媒体指标不可用时不显示伪造兜底价。
-- 画布预检允许透明源图，并按相同的 4× 规则复核输出尺寸与价格；输入文件沿用 20MiB 安全上限。
-- 已完成端点、请求体、固定倍率、alpha 预检与像素阶梯计价的离线测试；未执行真实付费生成。
-
-## 一手资料
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| API 文档 | https://fal.ai/models/topaz/upscale/image/transparent/api | 否 |
-| OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/transparent | 否 |
-| API Key | https://fal.ai/dashboard/keys | 是 |
+# Topaz 透明图放大（Fal）
+
+## 契约
+
+| 项目 | 内容 |
+|---|---|
+| endpoint ID | `topaz/upscale/image/transparent` |
+| 输入 | `image_url`，应用严格要求 1 张图片 |
+| 输出 | 固定 4×、固定 PNG，保留 alpha 通道；`image: File` |
+| 参数 | 无用户参数；官方 `output_format` 固定为 PNG，应用不重复下发 |
+| 价格 | 每开始 24 输出 MP `$0.08`，按实际固定 4× 输出尺寸估价 |
+| 资料核查 | 2026-08-29；公开，无需登录 |
+
+## 队列与鉴权
+
+使用 `Authorization: Key <FAL_KEY>` 调用 `https://queue.fal.run`：提交后轮询
+`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`，再从结果中的 `image.url` 获取输出；取消使用 endpoint 与
+`request_id` 组成的 `/cancel` 地址。复用 SDK 现有 Fal 上传、轮询、取消和结果解析，不新增协议分支。
+
+## 适配决策
+
+- canonical ID：`topaz-transparent-upscale`；应用模型 ID：`fal-ai-topaz-transparent-upscale`。
+- 该模型独立于 Topaz 主入口，避免把固定 4× 和透明语义伪装成普通倍率选项。
+- `pricing.mediaContext` 声明固定 4× 的输出面积换算，宿主共享价格层读取源图尺寸后按输出 MP 阶梯估价；媒体指标不可用时不显示伪造兜底价。
+- 画布预检允许透明源图，并按相同的 4× 规则复核输出尺寸与价格；输入文件沿用 20MiB 安全上限。
+- 已完成端点、请求体、固定倍率、alpha 预检与像素阶梯计价的离线测试；未执行真实付费生成。
+
+## 一手资料
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| API 文档 | https://fal.ai/models/topaz/upscale/image/transparent/api | 否 |
+| OpenAPI | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=topaz/upscale/image/transparent | 否 |
+| API Key | https://fal.ai/dashboard/keys | 是 |

package/docs/model-adaptation/Veo-3.1/Veo-3.1_APIMart.md

@@ -0,0 +1,90 @@
+# Veo 3.1 · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 模态 | 视频 |
+| 供应商 | APIMart（聚合平台） |
+| 项目模型 ID | `apimart-veo-3.1`（通用标识 `veo-3.1`，与已过时的 `fal-ai-veo-3.1` 相同） |
+| 平台模型 ID | Ext：`veo3.1-fast` / `veo3.1-quality` / `veo3.1-lite`（兼容别名 `-ext` 后缀）；官方：`veo3.1-fast-official` / `veo3.1-quality-official` |
+| 接口形态 | 异步任务 |
+| 文档 / 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- 提交：`POST /v1/videos/generations` → `data[0].task_id`
+- 查询：`GET /v1/tasks/{task_id}`，完成后读 `data.result.videos[0].url[0]`，链接有效 72 小时
+
+## 2. 渠道与能力
+
+| 能力 | Ext Fast | Ext Quality | Ext Lite | 官方 Fast / Quality |
+|---|---|---|---|---|
+| 文生视频 | 支持 | 支持 | 支持 | 支持 |
+| 首帧 / 首尾帧 | `image_urls` 1–2 张，`generation_type: frame` | 同左 | **不支持图片** | `first_frame_image` / `last_frame_image` |
+| 参考图生视频 | `image_urls` ≤ 3，`generation_type: reference` | **不支持** | 不支持 | 不支持 |
+| 时长 | 固定 8 秒 | 固定 8 秒 | 固定 8 秒 | 4 / 6 / 8 秒 |
+| 分辨率 | 720p / 1080p / 4k | 同左 | 同左 | 720p / 1080p / 4K |
+| 音频开关 | 无 | 无 | 无 | `generate_audio`，默认 false |
+
+## 3. 请求参数
+
+### 3.1 Ext
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `model` | `veo3.1-fast` / `veo3.1-quality` / `veo3.1-lite` | |
+| `prompt` | 必填 | |
+| `duration` | 固定 8 | |
+| `aspect_ratio` | `16:9` / `9:16` | |
+| `resolution` | `720p`（默认）/ `1080p` / `4k` | |
+| `generation_type` | `frame` / `reference` | 不传按图片数自动判断；Quality 不支持 reference；Lite 不能传 |
+| `image_urls` | ≤ 3，≤ 10MB，jpeg/jpg/png/webp | Lite 不能传 |
+| `enable_gif` | boolean | 项目不请求 |
+| `official_fallback` | boolean | 项目不请求 |
+| `nsfw_check` | 默认 false | 项目固定 false |
+
+### 3.2 官方
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `model` | `veo3.1-fast-official` / `veo3.1-quality-official` | |
+| `prompt` | 必填，建议英文 | |
+| `duration` | 4 / 6 / 8，默认 8 | 纯数字 |
+| `aspect_ratio` | `16:9` / `9:16` | |
+| `resolution` | `720p` / `1080p` / `4K` | 注意 4K 大写 |
+| `first_frame_image` / `last_frame_image` | 公网 URL | |
+| `generate_audio` | boolean，默认 false | |
+| `negative_prompt` / `seed` / `sample_count` / `person_generation` / `resize_mode` | | 项目不显示、不请求 |
+| `enhance_prompt` | 只能 true | 项目不请求 |
+
+## 4. 价格
+
+来源：[Veo 3.1 模型页](https://apimart.ai/zh/model/veo-3-1)（2026-11-07 读取，黄金价 = 当前价）；定价中心起步价 `veo3.1-fast-ext $0.14/次`、`veo3.1-lite-ext $0.07/次`、`veo3.1-quality-ext $1/次`、`veo3.1-fast-official $0.064/秒`、`veo3.1-quality-official $0.16/秒` 一致。
+
+| 型号 | 720P / 1080P | 4K |
+|---|---|---|
+| Ext Fast | $0.14 / 次 | $0.64 / 次 |
+| Ext Quality | $1 / 次 | $1.5 / 次 |
+| Ext Lite | $0.07 / 次 | $0.57 / 次 |
+
+| 官方（每秒） | 720P | 720P+音频 | 1080P | 1080P+音频 | 4K | 4K+音频 |
+|---|---|---|---|---|---|---|
+| Fast | $0.064 | $0.08 | $0.08 | $0.096 | $0.2 | $0.24 |
+| Quality | $0.16 | $0.32 | $0.16 | $0.32 | $0.32 | $0.48 |
+
+## 5. 项目适配
+
+- Fal 的 Veo 3.1 于 2026-11-17 下线，APIMart 作为替代渠道接入同一通用标识 `veo-3.1`。
+- 一个产品模型：`role: 'channel'` 渠道（默认 Ext）+ `role: 'mode'` 版本（Fast / Quality / Lite；官方渠道联动隐藏 Lite，旧值回到 Fast）。
+- 模式（文/图生视频、参考图生视频）只在 Ext Fast 显示；文/图生视频按图片数：0 张文生，1 张首帧，2 张首尾帧。
+- 时长与音频开关只在官方渠道显示，音频默认开启。
+- 不显示、不请求：`enable_gif`、`official_fallback`、`negative_prompt`、`seed`、`sample_count`、`person_generation`、`resize_mode`、`enhance_prompt`。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Ext API 文档 | https://docs.apimart.ai/cn/api-reference/videos/veo3/generation | 否 |
+| 官方 API 文档 | https://docs.apimart.ai/cn/api-reference/videos/veo3/generation-official | 否 |
+| 模型页（价格） | https://apimart.ai/zh/model/veo-3-1 | 否 |
+| 定价中心（起步价） | https://apimart.ai/zh/pricing | 否 |

package/docs/model-adaptation/Wan-2.7-Image/Wan-2.7-Image_APIMart.md

@@ -0,0 +1,81 @@
+# Wan 2.7 Image · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 图片 |
+| 供应商 | APIMart（聚合平台） |
+| 项目模型 ID | `apimart-wan-2.7-image`（通用标识 `wan-2.7-image`；仓库内其他供应商暂无此模型） |
+| 供应商展示名 | wan2.7-image / wan2.7-image-pro（模型页 `/zh/model/wan-2-7-image`、`/zh/model/wan-2-7-image-pro`） |
+| 平台模型 ID | `wan2.7-image`（标准版）、`wan2.7-image-pro`（Pro） |
+| 接口形态 | 异步任务 |
+| 文档 / 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- 提交：`POST https://api.apimart.ai/v1/images/generations`，`Authorization: Bearer <key>`。
+- 提交响应（官方示例）：`{"code":"success","data":[{"task_id":"task_01HX...","status":"processing"}]}`，取 `data[0].task_id`。
+- 查询：`GET /v1/tasks/{task_id}`，轮询到 `status == completed`；结果在 `data.result.images[].url[]`（APIMart 公共协议，见 `供应商/APIMart.md`）。
+- 错误：400 参数无效、401 鉴权失败、402 余额不足、429 频率限制、500 服务端错误，错误体 `{error:{code,message,type}}`。
+
+## 2. 能力
+
+文生图、图像编辑（传 `image_urls` 自动进入编辑模式）、多图参考（≤ 9 张）、组图（`enable_sequential`，一次生成风格一致的一组图）、交互式框选编辑（`bbox_list`）。
+
+| 版本 | 文生图最高分辨率 | 编辑 / 组图最高分辨率 |
+|---|---|---|
+| `wan2.7-image-pro` | 4K | 2K |
+| `wan2.7-image` | 2K | 2K |
+
+## 3. 请求参数
+
+| 字段 | 类型 / 取值 | 说明 |
+|---|---|---|
+| `model` | 必填，`wan2.7-image` / `wan2.7-image-pro` | |
+| `prompt` | string，≤ 5000 字符 | 文生图必填；编辑模式可选 |
+| `image_urls` | string[]，≤ 9 张 | HTTP(S) 或 `data:image/...;base64`；JPEG/PNG/WEBP/BMP，边长 240–8000 px，宽高比 1:8–8:1，单张 ≤ 20MB；传图后输出比例跟随**最后一张**输入图，编辑模式最高 2K |
+| `n` | integer，默认 1 | 非组图 1–4；组图 1–12；按成功张数计费，提交时按 `n` 预扣 |
+| `size` | string | 档位 `1K`/`2K`(默认)/`4K`，或比例 `1:1` `16:9` `9:16` `4:3` `3:4` `3:2` `2:3`（按 2K 换算），或像素 `1024x1024` |
+| `resolution` | `1K` / `2K` / `4K` | 可与 `size`（比例）配合；4K 仅 Pro 非组图文生图；像素范围标准版与 Pro 编辑/组图 768²–2048²，Pro 文生图 768²–4096² |
+| `enable_sequential` | boolean，默认 false | 组图模式；开启后 `thinking_mode`、`color_palette` 不生效，Pro 组图最高 2K |
+| `thinking_mode` | boolean，默认 true | 仅非组图且无输入图时生效 |
+| `negative_prompt` | string | |
+| `watermark` | boolean，默认 false | 右下角“AI 生成”水印 |
+| `seed` | 0–2147483647 | |
+| `bbox_list` | `[[[x1,y1,x2,y2],...],...]` | 外层长度等于 `image_urls`；无框选的图传 `[]`；每张最多 2 个框，原图绝对像素 |
+| `color_palette` | `[{hex,ratio}]`，3–10 项 | 仅非组图；ratio 之和须为 100.00% |
+| `nsfw_check` | boolean，默认 false | APIMart provider 统一强制 `false` |
+
+## 4. 价格
+
+来源：模型页价格表（2026-11-07 读取，“黄金价 = 当前价格”）；定价中心图像区同值。
+
+| 平台模型 ID | 当前价（黄金） | 铂金 | 钻石 | 官方价 |
+|---|---|---|---|---|
+| `wan2.7-image` | **$0.0216 / 张** | $0.0205 | $0.0194 | $0.027 |
+| `wan2.7-image-pro` | **$0.0544 / 张** | $0.0517 | $0.049 | $0.068 |
+
+- 按成功生成张数 × 单价计费，输入图不计费，与分辨率、比例无关；失败不扣费。
+- **冲突记录**：API 文档正文写 `¥0.20 / 张`、`¥0.50 / 张`（人民币标注），与模型页美元价不一致；按「模型专属页 > 实时价格页 > API 文档正文」取模型页美元价。
+
+## 5. 项目适配
+
+- 一个产品模型：版本（标准 / Pro）`role: 'mode'`，两版共用比例、分辨率、数量与组图参数。
+- 比例默认“智能”：无图时发具体比例（智能回退 `1:1`）到 `size`；有图时不发比例（平台跟随最后一张图）。分辨率发 `resolution`。
+- 4K 只在 Pro + 非组图 + 无输入图时可选（展示联动裁剪菜单并重置；builder 同时拒绝非法组合）。
+- 数量非组图 1–4、组图 1–12；关闭组图时数量超过 4 自动回到 4。
+- 不显示、不请求：`seed`、`negative_prompt`、`watermark`（平台默认 false）、`thinking_mode`（用平台默认 true）、`nsfw_check`（provider 强制 false）。
+- 暂不接：`bbox_list` 框选编辑（需要应用内派生媒体编辑器）、`color_palette`。
+
+- 界面与请求一致（2026-11-08“所选即所发”离线检查）：有输入图时平台按最后一张图定比例、不发送 size，比例参数在带图时隐藏。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| API 文档（中文） | https://docs.apimart.ai/cn/api-reference/images/wan2.7-image/generation | 否 |
+| API 文档（英文） | https://docs.apimart.ai/en/api-reference/images/wan2.7-image/generation | 否 |
+| 任务查询 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
+| 标准版模型页（价格表） | https://apimart.ai/zh/model/wan-2-7-image | 否 |
+| Pro 模型页（价格表） | https://apimart.ai/zh/model/wan-2-7-image-pro | 否 |
+| 定价中心 | https://apimart.ai/zh/pricing | 否 |

package/docs/model-adaptation/Wan-3.0/Wan-3.0_APIMart.md

@@ -0,0 +1,74 @@
+# Wan 3.0 · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 视频 |
+| 供应商 | APIMart（聚合平台） |
+| 项目模型 ID | `apimart-wan-3.0`（通用标识 `wan-3.0`） |
+| 平台模型 ID | `wan3.0-video`、`wan3.0-video-prime`（参数一致，独立型号与价格） |
+| 接口形态 | 异步任务 |
+| 文档 / 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- 提交：`POST /v1/videos/generations` → `data[0].task_id`
+- 查询：`GET /v1/tasks/{task_id}`；通常 1–5 分钟；结果转存平台 CDN，返回地址可长期使用
+- 参数错误均为同步 400，不建任务、不扣费
+
+## 2. 能力（统一入口，按传参自动承接）
+
+| 模式 | 传参 |
+|---|---|
+| 文生视频 | 仅 `prompt` |
+| 首帧 / 首尾帧 | `image_urls` 1 / 2 张（首尾帧族），或 `image_with_roles` |
+| 参考生视频 | 参考图 ≤ 10、参考视频 ≤ 5（单段 1–15 秒，总 ≤ 15 秒）、参考音频 ≤ 5（同上）；`prompt` 用“图1”“视频1”“音频1”指代 |
+| 参考文件 / 网页 | `file_url` 或 `link_url`（二选一，可无 `prompt`） |
+
+首尾帧族与参考族不能混用；裸 `image_urls` 由 `generation_type`（`frame` / `reference`）决定归属，未传时有参考族输入归参考图，否则归首尾帧。
+
+## 3. 请求参数
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `model` | `wan3.0-video` / `wan3.0-video-prime` | 必填 |
+| `prompt` | ≤ 20000 字符（超出自动截断） | 与素材至少填其一 |
+| `resolution` | `480P` / `720P` / `1080P` | **默认 1080P（最贵）**，项目始终显式传 |
+| `size`（或 `aspect_ratio`） | `adaptive` / `16:9` / `4:3` / `1:1` / `3:4` / `9:16` | 默认 `adaptive` |
+| `duration` | 2–30，或 `-1`（模型决定） | 默认 5；有参考视频时输入总时长 + 输出时长 ≤ 30 |
+| `audio` | boolean | 默认 true，开关同价 |
+| `generation_type` | `frame` / `reference` | |
+| `image_urls` / `image_with_roles` / `video_urls` / `audio_urls` / `audio_url` | 公网 URL | 图片单边 240–8000 px；视频 mp4/mov ≤ 100MB；音频 wav/mp3 ≤ 15MB |
+| `file_url` / `link_url` | 文档 / 公开网页 | 项目暂不接入 |
+| `nsfw_check` | boolean | 默认 false，项目固定 false |
+| `seed` / `watermark` | | 项目不显示、不请求 |
+
+## 4. 价格
+
+来源：[Wan 3.0 模型页](https://apimart.ai/zh/model/wan-3-0) 与 [Wan 3.0 Prime 模型页](https://apimart.ai/zh/model/wan-3-0-prime)（2026-11-07 读取，黄金价 = 当前价）；定价中心起步价 `wan3.0-video $0.0329/秒`、`wan3.0-video-prime $0.0514/秒` 一致。
+
+| 分辨率 | wan3.0-video（每秒） | wan3.0-video-prime（每秒） |
+|---|---|---|
+| 480P | $0.03288 | $0.05143 |
+| 720P | $0.06575 | $0.10286 |
+| 1080P | $0.1315 | $0.20571 |
+
+计费按 `duration` 秒数 × 分辨率单价；`duration: -1` 按实际产出秒数；音频开关同价。API 文档写的人民币刊例（480P ¥0.30/秒等）是官方刊例，项目以 APIMart 模型页美元价为准。
+
+## 5. 项目适配
+
+- 素材尺寸前置校验（2026-11-08）：`imageConstraints` 图片单边 240–8000 px。提交前读取素材实际宽高，不合格直接提示，不发付费请求。
+- 一个产品模型，`role: 'mode'` 版本（标准 / Prime）+ `role: 'mode'` 模式（文/图生视频、参考生视频）。
+- 文/图生视频：0 张文生，1 张首帧，2 张首尾帧，显式发 `generation_type: "frame"`；参考模式显式发 `generation_type: "reference"`。
+- 比例默认“智能”→ 发 `adaptive`（平台原生取值，有素材跟随素材）。
+- 分辨率默认 720P 并始终显式发送，避免平台按 1080P 计费。
+- 未接入：`file_url` / `link_url`（APIMart 没有文档上传端点）、`duration: -1`、`seed`、`watermark`。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| API 文档 | https://docs.apimart.ai/cn/api-reference/videos/wan3.0-video/generation | 否 |
+| Wan 3.0 模型页（价格） | https://apimart.ai/zh/model/wan-3-0 | 否 |
+| Wan 3.0 Prime 模型页（价格） | https://apimart.ai/zh/model/wan-3-0-prime | 否 |
+| 定价中心（起步价） | https://apimart.ai/zh/pricing | 否 |

package/docs/model-adaptation/Wan-3.0/Wan-3.0_Fal.md

@@ -0,0 +1,60 @@
+# Wan 3.0（含 Prime）· Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 模态 | 视频 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `alibaba/wan-3.0/{text-to-video,image-to-video,reference-to-video}`、`alibaba/wan-3.0-prime/{同上}` |
+| 痕迹AI 模型 ID | `fal-ai-wan-3.0`（canonical `wan-3.0`），标准 / Prime 用「版本」切换 |
+| 接口形态 | Fal 队列异步 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 请求参数（OpenAPI，2026-11-07 读取；标准与 Prime 字段相同）
+
+| 字段 | 类型 | 必填 | 默认 | 说明 |
+|---|---|---|---|---|
+| `prompt` | string | 文生必填 | — | 最长 20000 字；参考模式用「Image 1 / Video 1」按位置指代 |
+| `resolution` | string | 否 | `1080p` | `480p` / `720p` / `1080p` |
+| `aspect_ratio` | string | 否 | `adaptive` | `adaptive` / `16:9` / `4:3` / `1:1` / `3:4` / `9:16` |
+| `duration` | integer \| null | 否 | `5` | 2–30；`null` 为智能时长（未接入） |
+| `audio` | boolean | 否 | `true` | 生成声音 |
+| `enable_prompt_expansion` | boolean | 否 | `true` | 关闭可省 20–60 秒，但通常降低质量 |
+| `enable_thinking` | boolean | 否 | `false` | 生成前推理 |
+| `seed` / `enable_safety_checker` | | 否 | | 不展示、不下发 |
+| `start_image_url` | string | 图生必填 | — | 首帧 |
+| `end_image_url` | string | 否 | — | 尾帧，需要首帧 |
+| `reference_image_urls` | array | 参考 | — | 最多 10 |
+| `reference_video_urls` | array | 参考 | — | 最多 5，合计 ≤15 秒，每段 ≥16fps；**输入视频时长另计费** |
+| `reference_audio_urls` | array | 参考 | — | 最多 5，合计 ≤15 秒 |
+| `web_url` / `file_url` | string | 参考 | — | 需要 `enable_thinking=true`；未接入 |
+
+响应：`{ "video": { "url" }, "seed", "duration", "actual_prompt" }`。
+
+## 2. 价格（模型页 pricingInfoOverride，2026-11-07 读取；页面注明价格可能调整）
+
+| 版本 | 480p | 720p | 1080p |
+|---|---|---|---|
+| 标准 | $0.05/秒 | $0.10/秒 | $0.20/秒 |
+| Prime | $0.068/秒 | $0.14/秒 | $0.28/秒 |
+
+参考生视频的参考视频输入时长与输出时长一起计费。
+
+## 3. 适配要点
+
+- 一个模型、两个主选择器：「版本」（标准 / Prime，切端点前缀）与「模式」（文/图生视频、参考生视频）。
+- 文/图生视频按图片数自动路由：0 张文生、1 张首帧、2 张首尾帧。
+- 智能比例下发 `adaptive`，交给平台按素材与提示词决定。
+- 计价：`单价 × (输出时长 + 参考视频总时长)`。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 标准文生视频 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=alibaba/wan-3.0/text-to-video | 否 |
+| 标准图生视频 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=alibaba/wan-3.0/image-to-video | 否 |
+| 标准参考生视频 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=alibaba/wan-3.0/reference-to-video | 否 |
+| Prime 文生 / 图生 / 参考 schema | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=alibaba/wan-3.0-prime/text-to-video （另两个端点同理） | 否 |
+| 标准版价格 | https://fal.ai/models/alibaba/wan-3.0/text-to-video | 否 |
+| Prime 价格 | https://fal.ai/models/alibaba/wan-3.0-prime/text-to-video | 否 |

package/docs/model-adaptation/Wan-3.0/Wan-3.0_Grsai.md

@@ -0,0 +1,35 @@
+# Wan 3.0 · Grsai
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 项目模型 | `grsai-wan-3.0`，通用标识 `wan-3.0`（Grsai 第一个视频模型） |
+| 平台 model | `wan-3.0`，模型列表标注“官方直连” |
+| 文档与价格 | 公开，无需登录 |
+| 定价（按秒） | 480p 3300、720p 6600、1080p 13200 积分/秒；基础充值档（1 积分 ≈ ¥0.0001）为 ¥0.33/¥0.66/¥1.32 每秒，模型列表按“积分/20000”给出的高额档参考价为 ¥0.165/¥0.33/¥0.66 |
+
+## 请求契约
+
+沿用 [Grsai 供应商文档](../供应商/Grsai.md) 的 `POST /v1/api/generate` + `GET /v1/api/result` 异步轮询（结果同在 `results[].url`），provider 发送边界统一补 `replyType: "async"`。
+
+| 字段 | 值与约束 | 项目处理 |
+|---|---|---|
+| model | `wan-3.0`，必填 | 固定 |
+| prompt | 必填 | 统一提示词 |
+| aspectRatio | 必填：16:9、9:16、21:9、4:3、1:1、3:4 | 智能比例本地转具体值 |
+| resolution | 必填：480p / 720p / 1080p | 展示，默认 720p |
+| duration | 必填：文档写 2–30 秒，接口实际要求大于 2 秒（2026-11-08 实调 2 秒返回 “duration must be greater than 2 seconds”） | 下拉 3–30 |
+| images | 参考图，base64 或 URL，≤10 张；与首尾帧互斥 | 参考模式 |
+| audios | 参考音频，base64 或 URL，≤5 段、每段 ≤15 秒；与首尾帧互斥 | 参考模式 |
+| firstFrame / lastFrame | 首帧、尾帧图片；与 images、audios 互斥 | 文/图生视频模式 |
+| seed | 可选 | 不显示、不请求 |
+
+模型列表说明“参考视频正在兼容中”，接口也没有参考视频字段，本轮不开放视频输入。
+
+## 原始链接索引
+
+均公开，无需登录：
+- [wan-video 接口](https://qmy27nhsd9.apifox.cn/531060669e0.md)
+- [异步生成结果查询接口](https://qmy27nhsd9.apifox.cn/452409577e0)
+- [模型列表与价格](https://grsai.com/zh/dashboard/models)
+- [充值档位](https://grsai.com/zh/dashboard/billing)

package/docs/model-adaptation/Wan-3.0/Wan-3.0_KIE.md

@@ -0,0 +1,38 @@
+# Wan 3.0 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 项目模型 | `kie-wan-3.0`，通用标识 `wan-3.0`；Prime 见 [Wan-3.0-Prime_KIE.md](../Wan-3.0-Prime/Wan-3.0-Prime_KIE.md) |
+| model ID | `wan/3-0-video` |
+| 文档与价格 | 公开，无需登录 |
+| 定价（每秒，按输出时长） | 480p $0.04、720p $0.08、1080p $0.16 |
+
+## 请求契约
+
+`POST https://api.kie.ai/api/v1/jobs/createTask`，`{model,input}`，单一端点。项目用显式模式区分“首尾帧”和“全能参考”，因为两组字段官方规定互斥。
+
+| input 字段 | 值与约束 | 项目处理 |
+|---|---|---|
+| prompt | ≤20000；文生视频必填，其他模式建议填；参考模式用 Image1/Video1/Audio1 指代 | 有内容才发送 |
+| first_frame_url / last_frame_url | 各 1 张；JPEG/PNG(不含透明)/BMP/WEBP；与 reference_* 互斥 | 文/图生视频模式：第 1 张首帧、第 2 张尾帧 |
+| reference_image_urls | ≤10 张 | 参考模式 |
+| reference_video_urls | ≤5 段，每段 1–15 秒、合计 ≤15 秒；mp4/mov，≤100MB；参考视频时长 + duration ≤ 30 | 参考模式（时长组合由服务端校验） |
+| reference_audio_urls | ≤5 段，每段 1–15 秒、合计 ≤15 秒；wav/mp3，≤15MB；可单独作为输入 | 参考模式 |
+| reference_file_urls / reference_link_urls | 文档或网页生成视频 | 本轮不显示、不请求 |
+| resolution | 480P / 720P / 1080P，默认 1080P | 界面小写，请求转大写；应用默认 720p |
+| aspect_ratio | adaptive（默认）、16:9、4:3、1:1、3:4、9:16 | 直接展示 adaptive |
+| duration | 无视频输入 2–30，默认 5；`-1` 为模型自定时长 | 下拉 2–30；`-1` 无法预估价格，不开放 |
+| audio | 是否带音轨，默认 true | 开关 |
+| seed / nsfw_checker | 可选 | 不显示、不请求 |
+
+## 事件与失败契约
+
+沿用 [KIE 供应商文档](../供应商/KIE.md) 第 2 节 Market 统一任务契约，未引入新轮询或解析分支。官方请求 schema 见 `tests/fixtures/model-requests-2026-11/kie-wan-3.0.json`；未做付费真网验收。
+
+## 原始链接索引
+
+均公开，无需登录：
+- [Wan 3.0 Video](https://docs.kie.ai/market/wan/3-0-video.md)
+- [模型页](https://kie.ai/wan3.0-video)
+- [实时价格页](https://kie.ai/pricing)（2026-11-07 核对 3 行 wan 3.0 video 价格）

package/docs/model-adaptation/Wan-3.0/Wan-3.0_/347/231/276/347/202/274.md

@@ -0,0 +1,96 @@
+# Wan 3.0 · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模态 | 视频 |
+| 供应商 | 阿里云百炼（官方） |
+| 项目模型 ID | `bailian-wan-3.0`（通用标识 `wan-3.0`） |
+| 平台模型 ID | `wan3.0-video`（标准版）、`wan3.0-video-prime`（官方称“高速版”：能力对齐标准版，端到端更快，单价更高） |
+| 接口形态 | 异步任务（HTTP 只支持异步） |
+| 文档 / 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- 提交：`POST /api/v1/services/aigc/video-generation/video-synthesis`，请求头必须带 `X-DashScope-Async: enable`（缺少时报 “current user api does not support synchronous calls”）；成功返回 `output.task_id` 与 `output.task_status: PENDING`
+- 查询：`GET /api/v1/tasks/{task_id}`；官方建议约 15 秒查询一次，查询 RPS 默认 20；`task_id` 24 小时内可查
+- 官方示例使用空间专属域名 `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com`；项目沿用百炼供应商统一的 `https://dashscope.aliyuncs.com`（官方保证历史地址可用，见 [百炼.md](../供应商/百炼.md) 第 1 节）。模型、Endpoint 与 API Key 必须同属北京地域
+- 结果 `output.video_url` 为 MP4（H.264），24 小时有效，按统一媒体转存链路落盘
+- 生成通常 1–5 分钟，最长可出 30 秒视频，30 fps
+
+## 2. 能力（按 `input.media[].type` 组合）
+
+| 场景 | media |
+|---|---|
+| 文生视频 | 不传 media，只传 `prompt` |
+| 首帧 / 首尾帧 | `first_frame` 1 张（+ `last_frame` 1 张）；不可与其他类型混用 |
+| 参考生视频 | `reference_image` ≤ 10、`reference_video` ≤ 5（单段 1–15 秒，总 ≤ 15 秒）、`reference_audio` ≤ 5（同上），自由组合；提示词用“图1”“视频1”“音频1”指代，图 / 视频 / 音频分别计数 |
+| 文件 / 网页生视频 | `file`（docx、pdf、pptx 等 ≤ 100MB / 50 页）或 `link`（公开网页）二选一，可再组合参考素材；此时 `prompt_extend` 必须为 true |
+| 视频编辑 / 延长 | 至少 1 个 `reference_video`，提示词写编辑或延长意图；延长需 `ratio: adaptive` |
+
+`prompt` 与 `media` 至少填一项；`prompt` ≤ 20000 字符，超出自动截断。
+
+输入格式：图片支持公网 URL、`oss://` 临时 URL 与 `data:{MIME};base64,` Data URI（JPEG/JPG/PNG/BMP/WEBP，单边 240–8000 px，长宽比 ≤ 8:1，≤ 20MB）；**视频、音频、文件只收公网 URL 或 `oss://` 临时 URL**。
+
+## 3. 请求参数
+
+| 字段 | 取值 | 项目处理 |
+|---|---|---|
+| `model` | `wan3.0-video` / `wan3.0-video-prime` | 由「版本」切换 |
+| `input.prompt` | string | 空提示词不发送 |
+| `input.media` | 见第 2 节 | 文/图生视频：1 张发 `first_frame`、2 张再加 `last_frame`；参考模式发 `reference_image`（最多 10 张） |
+| `parameters.resolution` | `1080P`（默认，最贵）/ `720P` / `480P` | 默认 720P，始终显式发送 |
+| `parameters.ratio` | `adaptive`（默认）/ `21:9` / `16:9` / `4:3` / `1:1` / `3:4` / `9:16` | 「智能」发 `adaptive` |
+| `parameters.duration` | 2–30，默认 5；`-1` 智能时长；有视频输入时输入总时长 + 输出时长 ≤ 30 | 2–30 |
+| `parameters.audio` | boolean，默认 true，开关同价 | 开关 |
+| `parameters.watermark` | boolean，默认 false | 固定 false |
+| `parameters.prompt_extend` | boolean，默认 true | 不发送（用官方默认） |
+| `parameters.seed` | -1 或 0–2147483647 | 不显示、不发送 |
+
+## 4. 价格
+
+来源：[模型价格](https://help.aliyun.com/zh/model-studio/model-pricing)「万相3.0-视频生成」（2026-11-07 读取，无需登录），华北2（北京），输入视频与输出视频同价，按秒计费，失败不计费：
+
+| 分辨率 | wan3.0-video（原价，当前限时 7 折） | wan3.0-video-prime |
+|---|---|---|
+| 480P | ¥0.3/秒 | ¥0.45/秒 |
+| 720P | ¥0.6/秒 | ¥0.9/秒 |
+| 1080P | ¥1.2/秒 | ¥1.8/秒 |
+
+- 计费时长 = 输入视频时长 + 输出视频时长；读不到参考视频时长时按输出时长估，封顶合计 15 秒。
+- 北京地域标准版有 30 秒免费额度（90 天内），Prime 无。
+- 项目按标准版**原价**预估，折扣期内实际账单更低；新加坡等地域单价不同，项目只用北京。
+
+## 5. 事件 / 状态矩阵
+
+| 状态 | 前置 | 字段契约 | 空值语义 | 下一状态 | 对外输出 | 终态 / 错误 |
+|---|---|---|---|---|---|---|
+| 提交成功 | — | `output.task_id` string、`output.task_status: PENDING`、`request_id` | 缺 `task_id` 判 `invalid_response` | PENDING | pending + taskId | 否 |
+| 提交失败 | — | 顶层 `code` / `message` / `request_id` | — | — | 无 | 是；`Arrearage`、`AccessDenied.Unpurchased`、`Model.AccessDenied` 与“模型未开通”文案按 `providerAccessErrors` 归类为不可重试 |
+| `PENDING` | 提交 | `output.task_status` | 无结果 | RUNNING | 无 | 否，继续查询 |
+| `RUNNING` | PENDING | 同上 | 无结果 | SUCCEEDED / FAILED | 无 | 否，继续查询 |
+| `SUCCEEDED` | RUNNING | `output.video_url` 必有；`usage.duration` / `output_video_duration` / `SR` / `ratio` | `video_url` 缺失或非 http(s) 判 `empty_result` | — | completed，URL 为视频 | 是 |
+| `FAILED` | PENDING / RUNNING | `output.code` / `output.message` | message 缺失时用固定原因 | — | 无 | 是，`provider_task_failed`（`code: message`），不续查 |
+| `CANCELED` | PENDING | — | — | — | 无 | 是 |
+| `UNKNOWN` | 任意 | 只有 `task_id` / `task_status` | 任务不存在或超过 24 小时查询期 | 保持 | 无 | 计入连续查询失败，连续 20 次后 `provider_task_unreachable` |
+| 缺状态 / 查询 HTTP 5xx / 网络错误 | 任意 | — | — | 保持 | 无 | 同上 |
+
+不变量：只有 `SUCCEEDED` 且带 `video_url` 才算有效 final；用户取消只停止本地查询（官方取消接口见「管理异步任务」，SDK 未接）；SDK 只看当次状态，不依赖状态顺序。
+
+## 6. 项目适配
+
+- 素材尺寸前置校验（2026-11-08）：`imageConstraints` 图片单边 240–8000 px、长宽比 ≤ 8:1。提交前读取素材实际宽高，不合格直接提示，不发付费请求。
+- 一个产品模型，`role: 'mode'` 版本（标准 / Prime）+ `role: 'mode'` 模式（文/图生视频、参考生视频），与 APIMart、Fal 同家族入口一致（KIE 把 Prime 拆成独立模型 `kie-wan-3.0-prime`）。
+- 图片走 Data URI；参考视频（≤ 5）、参考音频（≤ 5）由百炼预处理按请求的 `model` 申请临时存储凭证（`/api/v1/uploads?action=getPolicy`）上传成 `oss://`，请求体含 `oss://` 时提交自动带 `X-DashScope-OssResourceResolve: enable`。视频编辑 / 延长不单设模式：参考模式带上视频、提示词写明意图即可（延长需「智能」比例）。
+- 未接入：`file` / `link`、`duration: -1`、`seed`、`prompt_extend` 开关、地域与业务空间域名配置。有视频输入时官方要求输入总时长 + 输出时长 ≤ 30 秒：读得到素材时长时，提交前把输出时长收进这个范围。
+- Fixture：`packages/ai-sdk/tests/fixtures/bailian/video-*.json`（提交成功、提交失败、成功、失败、UNKNOWN 均为官方原样示例）；状态迁移与请求头测试：`packages/ai-sdk/tests/providers/video-async-official.test.ts`；请求构建与价格：`packages/ai-sdk/tests/catalog/official-videos.test.ts`。未做真实付费调用。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 万相 3.0 视频生成 API 参考 | https://help.aliyun.com/zh/model-studio/wan3-video-generation-api-reference | 否 |
+| 模型价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
+| 模型列表 | https://help.aliyun.com/zh/model-studio/models | 否 |
+| 上传文件获取临时 URL | https://help.aliyun.com/zh/model-studio/get-temporary-file-url | 否 |
+| 控制台模型卡片 | https://bailian.console.aliyun.com/cn-beijing/model/market/detail/wan3.0-video | 是 |

package/docs/model-adaptation/Wan-3.0-Prime/Wan-3.0-Prime_KIE.md

@@ -0,0 +1,20 @@
+# Wan 3.0 Prime · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 项目模型 | `kie-wan-3.0-prime`，通用标识 `wan-3.0-prime` |
+| model ID | `wan/3-0-video-prime` |
+| 文档与价格 | 公开，无需登录 |
+| 定价（每秒，按输出时长） | 480p $0.0612、720p $0.126、1080p $0.252 |
+
+## 请求契约
+
+字段、枚举、互斥规则与 [Wan 3.0](../Wan-3.0/Wan-3.0_KIE.md) 逐项一致（2026-11-07 对比两份官方 schema），只有 model ID 与单价不同。项目两者共用 `catalog/kie/wan30.ts` 构建请求。
+
+## 原始链接索引
+
+均公开，无需登录：
+- [Wan 3.0 Video Prime](https://docs.kie.ai/market/wan/3-0-video-prime.md)
+- [模型页](https://kie.ai/wan3.0-video-prime)
+- [实时价格页](https://kie.ai/pricing)（2026-11-07 核对 3 行 wan3.0 video prime 价格）