@henjicc/ai-sdk 0.2.8 → 0.4.0

package/docs/model-adaptation/Wan-2.5-Preview/Wan-2.5-Preview_/346/264/276/346/254/247/344/272/221.md

@@ -1,82 +1,82 @@
-# Wan 2.5 Preview · 派欧云 PPIO
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-26 |
-| 模态 | 视频 |
-| 供应商 | 派欧云 PPIO |
-| 平台路由 | `/v3/async/wan-2.5-t2v-preview`、`/v3/async/wan-2.5-i2v-preview` |
-| 接口形态 | **异步任务** |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-| 调用前提 | ⚠️ **需要个人或企业实名认证** |
-
-供应商公共协议见 [供应商/派欧云.md](../供应商/派欧云.md)。
-
-## 1. 能力与价格
-
-**按视频条数计费**：
-
-| 分辨率 | 5 秒 | 10 秒 |
-|---|---|---|
-| 480P | ¥1.5 | ¥3 |
-| 720P | ¥3 | ¥6 |
-| 1080P | ¥5 | ¥10 |
-
-文生视频与图生视频同价。
-
-## 2. 请求体结构
-
-嵌套结构 `{ "input": {...}, "parameters": {...} }`。
-
-### `input`
-
-| 变体 | 字段 | 类型 | 必填 | 约束 |
-|---|---|---|---|---|
-| t2v | `prompt` | string | ✅ | ≤ 2000 |
-| | `negative_prompt` | string | | ≤ 500 |
-| | `audio_url` | string | | wav/mp3，3–30 秒，≤15MB |
-| i2v | `img_url` | string | ✅ | JPEG/JPG/PNG（**不支持带透明通道**）/BMP/WEBP；宽高 [360, 2000]px；≤10MB |
-| | `prompt` | string | | ≤ 2000 |
-| | `negative_prompt` | string | | ≤ 500 |
-| | `audio_url` | string | | 同上 |
-
-### `parameters`
-
-| 字段 | 类型 | 默认 | 约束 |
-|---|---|---|---|
-| `size` | string | `1920*1080` | **仅 t2v**；必须填具体像素，不接受档位名或比例 |
-| `resolution` | string | `1080P` | **仅 i2v**；枚举 `480P` / `720P` / `1080P` |
-| `duration` | integer | `5` | 枚举 `5` / `10` |
-| `prompt_extend` | boolean | `true` | |
-| `watermark` | boolean | `false` | |
-| `audio` | boolean | `true` | **优先级：`audio_url` > `audio`** |
-| `seed` | integer | — | `[0, 2147483647]` |
-
-`size` 合法值（13 个，三档）：
-
-- 480P：`832*480` `480*832` `624*624`
-- 720P：`1280*720` `720*1280` `960*960` `1088*832` `832*1088`
-- 1080P：`1920*1080` `1080*1920` `1440*1440` `1632*1248` `1248*1632`
-
-> **官方默认是 1080P**（`size` 默认 `1920*1080`、`resolution` 默认 `1080P`）。项目当前 `wan-2.5-preview.model.ts` 的默认值是 720P（`DEFAULT_WAN25_SIZE='1280*720'`、`DEFAULT_WAN25_RESOLUTION='720P'`），比官方默认低一档。这不是错误，但用户不主动切换时看到的预估价会比官方默认低，需要确认是有意的省钱默认值还是遗漏。
-
-## 3. 上传要求
-
-`img_url` 与 `audio_url` 都以 `_url` 结尾 → 走 **`public-url` 模式**，需要公网 URL，本项目借用 KIE 上传服务。**未配置 KIE API Key 时图生视频不可用。**
-
-## 4. 适配要点
-
-- **实名认证是硬前提**，未认证用户调用会直接失败，且这个限制不体现在错误码文档里。产品侧需要有对应的错误提示引导。
-- t2v 用 `size`（具体像素）、i2v 用 `resolution`（档位名），计价函数需要按当前模式读不同字段再归档。
-- 计价是查表（分辨率 × 时长），不是按秒线性。
-- `audio_url` 存在时会覆盖 `audio` 开关。
-- 项目默认隐藏 `seed` 与负面提示词，按约定**不显示、不请求**。
-
-## 5. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| 文生视频 | https://ppio.com/docs/models/reference-wan-2.5-t2v-preview | 否 |
-| 图生视频 | https://ppio.com/docs/models/reference-wan-2.5-i2v-preview | 否 |
-| 定价页（视频 tab） | https://ppio.com/pricing | 否 |
+# Wan 2.5 Preview · 派欧云 PPIO
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-26 |
+| 模态 | 视频 |
+| 供应商 | 派欧云 PPIO |
+| 平台路由 | `/v3/async/wan-2.5-t2v-preview`、`/v3/async/wan-2.5-i2v-preview` |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+| 调用前提 | ⚠️ **需要个人或企业实名认证** |
+
+供应商公共协议见 [供应商/派欧云.md](../供应商/派欧云.md)。
+
+## 1. 能力与价格
+
+**按视频条数计费**：
+
+| 分辨率 | 5 秒 | 10 秒 |
+|---|---|---|
+| 480P | ¥1.5 | ¥3 |
+| 720P | ¥3 | ¥6 |
+| 1080P | ¥5 | ¥10 |
+
+文生视频与图生视频同价。
+
+## 2. 请求体结构
+
+嵌套结构 `{ "input": {...}, "parameters": {...} }`。
+
+### `input`
+
+| 变体 | 字段 | 类型 | 必填 | 约束 |
+|---|---|---|---|---|
+| t2v | `prompt` | string | ✅ | ≤ 2000 |
+| | `negative_prompt` | string | | ≤ 500 |
+| | `audio_url` | string | | wav/mp3，3–30 秒，≤15MB |
+| i2v | `img_url` | string | ✅ | JPEG/JPG/PNG（**不支持带透明通道**）/BMP/WEBP；宽高 [360, 2000]px；≤10MB |
+| | `prompt` | string | | ≤ 2000 |
+| | `negative_prompt` | string | | ≤ 500 |
+| | `audio_url` | string | | 同上 |
+
+### `parameters`
+
+| 字段 | 类型 | 默认 | 约束 |
+|---|---|---|---|
+| `size` | string | `1920*1080` | **仅 t2v**；必须填具体像素，不接受档位名或比例 |
+| `resolution` | string | `1080P` | **仅 i2v**；枚举 `480P` / `720P` / `1080P` |
+| `duration` | integer | `5` | 枚举 `5` / `10` |
+| `prompt_extend` | boolean | `true` | |
+| `watermark` | boolean | `false` | |
+| `audio` | boolean | `true` | **优先级：`audio_url` > `audio`** |
+| `seed` | integer | — | `[0, 2147483647]` |
+
+`size` 合法值（13 个，三档）：
+
+- 480P：`832*480` `480*832` `624*624`
+- 720P：`1280*720` `720*1280` `960*960` `1088*832` `832*1088`
+- 1080P：`1920*1080` `1080*1920` `1440*1440` `1632*1248` `1248*1632`
+
+> **官方默认是 1080P**（`size` 默认 `1920*1080`、`resolution` 默认 `1080P`）。项目当前 `wan-2.5-preview.model.ts` 的默认值是 720P（`DEFAULT_WAN25_SIZE='1280*720'`、`DEFAULT_WAN25_RESOLUTION='720P'`），比官方默认低一档。这不是错误，但用户不主动切换时看到的预估价会比官方默认低，需要确认是有意的省钱默认值还是遗漏。
+
+## 3. 上传要求
+
+`img_url` 与 `audio_url` 都以 `_url` 结尾 → 走 **`public-url` 模式**，需要公网 URL，本项目借用 KIE 上传服务。**未配置 KIE API Key 时图生视频不可用。**
+
+## 4. 适配要点
+
+- **实名认证是硬前提**，未认证用户调用会直接失败，且这个限制不体现在错误码文档里。产品侧需要有对应的错误提示引导。
+- t2v 用 `size`（具体像素）、i2v 用 `resolution`（档位名），计价函数需要按当前模式读不同字段再归档。
+- 计价是查表（分辨率 × 时长），不是按秒线性。
+- `audio_url` 存在时会覆盖 `audio` 开关。
+- 项目默认隐藏 `seed` 与负面提示词，按约定**不显示、不请求**。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文生视频 | https://ppio.com/docs/models/reference-wan-2.5-t2v-preview | 否 |
+| 图生视频 | https://ppio.com/docs/models/reference-wan-2.5-i2v-preview | 否 |
+| 定价页（视频 tab） | https://ppio.com/pricing | 否 |

package/docs/model-adaptation/Wan-2.6/Wan-2.6_/346/264/276/346/254/247/344/272/221.md

@@ -1,84 +1,84 @@
-# Wan 2.6 · 派欧云 PPIO
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-26 |
-| 模态 | 视频 |
-| 供应商 | 派欧云 PPIO |
-| 平台路由 | `/v3/async/wan2.6-{t2v,i2v,v2v}` |
-| 接口形态 | **异步任务** |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-供应商公共协议见 [供应商/派欧云.md](../供应商/派欧云.md)。
-
-## 1. 能力与价格
-
-**按视频条数计费**（不是按秒），查表如下：
-
-| 变体 | 路由 | 720P | 1080P |
-|---|---|---|---|
-| 文生视频 | `/v3/async/wan2.6-t2v` | 5s ¥3 / 10s ¥6 / 15s ¥9 | 5s ¥5 / 10s ¥10 / 15s ¥15 |
-| 图生视频 | `/v3/async/wan2.6-i2v` | 同上 | 同上 |
-| 参考生视频 | `/v3/async/wan2.6-v2v` | 5s ¥3 / 10s ¥6 | 5s ¥5 / 10s ¥10 |
-
-**v2v 只支持 5s 和 10s，没有 15s 档。**
-
-## 2. 请求体结构
-
-Wan 2.6 是**嵌套结构** `{ "input": {...}, "parameters": {...} }`，与 Wan 2.5 相同，与 Wan 2.7 的扁平结构不同。
-
-### `input`
-
-| 变体 | 字段 | 类型 | 必填 | 约束 |
-|---|---|---|---|---|
-| t2v | `prompt` | string | ✅ | 0–2000 |
-| | `audio_url` | string | | |
-| | `negative_prompt` | string | | 0–500 |
-| i2v | `img_url` | string | ✅ | URL 或 base64 `data:{MIME};base64,{data}`；[360, 2000]px，≤10MB |
-| | `prompt` | string | | 0–2000 |
-| | `template` | string | | 视频特效模板名 |
-| | `audio_url` | string | | |
-| | `negative_prompt` | string | | 0–500 |
-| v2v | `prompt` | string | ✅ | 0–1500，用 `character1` / `character2` 引用角色 |
-| | `reference_urls` | string[] | ✅ | 长度 1–5；图 0–5 张 + 视频 0–3 个，总数 ≤5；视频 1–30 秒 ≤100MB，图 [240, 8000]px ≤20MB |
-| | `negative_prompt` | string | | 0–500 |
-
-### `parameters`
-
-| 字段 | 类型 | 默认 | 约束 |
-|---|---|---|---|
-| `size` | string | `1920*1080` | **仅 t2v 与 v2v**；具体像素值，10 个枚举（720P/1080P 两档） |
-| `resolution` | string | `1080P` | **仅 i2v**；枚举 `720P` / `1080P` |
-| `duration` | integer | `5` | t2v/i2v 枚举 `5/10/15`；**v2v 只有 `5/10`** |
-| `audio` | boolean | `true` | |
-| `shot_type` | string | — | 枚举 `single` / `multi`；**t2v/i2v 默认 `multi`，v2v 默认 `single`** |
-| `prompt_extend` | boolean | `true` | |
-| `watermark` | boolean | `false` | |
-| `seed` | integer | — | `[0, 2147483647]` |
-
-`size` 枚举：720P `1280*720` `720*1280` `960*960` `1088*832` `832*1088`；1080P `1920*1080` `1080*1920` `1440*1440` `1632*1248` `1248*1632`
-
-> **t2v/v2v 用 `size`、i2v 用 `resolution`** 是 Wan 家族的通用规律，三个版本都一样，最容易踩坑的地方。
-
-## 3. 上传要求
-
-`img_url`、`audio_url`、`reference_urls` 都以 `_url` / `_urls` 结尾 → 走 **`public-url` 模式**，需要公网 URL，本项目借用 KIE 上传服务。**未配置 KIE API Key 时图生视频与参考生视频不可用。**
-
-文档同时说明 `img_url` 接受 base64 data URL，但本项目的 `ppio-media.ts` 按字段名后缀判定为 `public-url`，不会走内联路径。
-
-## 4. 适配要点
-
-- `shot_type` 的默认值按变体不同（t2v/i2v 是 `multi`，v2v 是 `single`），不能写成统一默认值。
-- `duration` 合法集合按变体不同（v2v 无 15s），UI 需按当前模式过滤选项。
-- 计价是查表（分辨率 × 时长），不是线性按秒，与 Wan 2.7 完全不同。
-- 项目默认隐藏 `seed` 与负面提示词，按约定**不显示、不请求**。
-
-## 5. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| 文生视频 | https://ppio.com/docs/models/reference-wan2.6-t2v | 否 |
-| 图生视频 | https://ppio.com/docs/models/reference-wan2.6-i2v | 否 |
-| 参考生视频 | https://ppio.com/docs/models/reference-wan2.6-v2v | 否 |
-| 定价页（视频 tab） | https://ppio.com/pricing | 否 |
+# Wan 2.6 · 派欧云 PPIO
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-26 |
+| 模态 | 视频 |
+| 供应商 | 派欧云 PPIO |
+| 平台路由 | `/v3/async/wan2.6-{t2v,i2v,v2v}` |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+供应商公共协议见 [供应商/派欧云.md](../供应商/派欧云.md)。
+
+## 1. 能力与价格
+
+**按视频条数计费**（不是按秒），查表如下：
+
+| 变体 | 路由 | 720P | 1080P |
+|---|---|---|---|
+| 文生视频 | `/v3/async/wan2.6-t2v` | 5s ¥3 / 10s ¥6 / 15s ¥9 | 5s ¥5 / 10s ¥10 / 15s ¥15 |
+| 图生视频 | `/v3/async/wan2.6-i2v` | 同上 | 同上 |
+| 参考生视频 | `/v3/async/wan2.6-v2v` | 5s ¥3 / 10s ¥6 | 5s ¥5 / 10s ¥10 |
+
+**v2v 只支持 5s 和 10s，没有 15s 档。**
+
+## 2. 请求体结构
+
+Wan 2.6 是**嵌套结构** `{ "input": {...}, "parameters": {...} }`，与 Wan 2.5 相同，与 Wan 2.7 的扁平结构不同。
+
+### `input`
+
+| 变体 | 字段 | 类型 | 必填 | 约束 |
+|---|---|---|---|---|
+| t2v | `prompt` | string | ✅ | 0–2000 |
+| | `audio_url` | string | | |
+| | `negative_prompt` | string | | 0–500 |
+| i2v | `img_url` | string | ✅ | URL 或 base64 `data:{MIME};base64,{data}`；[360, 2000]px，≤10MB |
+| | `prompt` | string | | 0–2000 |
+| | `template` | string | | 视频特效模板名 |
+| | `audio_url` | string | | |
+| | `negative_prompt` | string | | 0–500 |
+| v2v | `prompt` | string | ✅ | 0–1500，用 `character1` / `character2` 引用角色 |
+| | `reference_urls` | string[] | ✅ | 长度 1–5；图 0–5 张 + 视频 0–3 个，总数 ≤5；视频 1–30 秒 ≤100MB，图 [240, 8000]px ≤20MB |
+| | `negative_prompt` | string | | 0–500 |
+
+### `parameters`
+
+| 字段 | 类型 | 默认 | 约束 |
+|---|---|---|---|
+| `size` | string | `1920*1080` | **仅 t2v 与 v2v**；具体像素值，10 个枚举（720P/1080P 两档） |
+| `resolution` | string | `1080P` | **仅 i2v**；枚举 `720P` / `1080P` |
+| `duration` | integer | `5` | t2v/i2v 枚举 `5/10/15`；**v2v 只有 `5/10`** |
+| `audio` | boolean | `true` | |
+| `shot_type` | string | — | 枚举 `single` / `multi`；**t2v/i2v 默认 `multi`，v2v 默认 `single`** |
+| `prompt_extend` | boolean | `true` | |
+| `watermark` | boolean | `false` | |
+| `seed` | integer | — | `[0, 2147483647]` |
+
+`size` 枚举：720P `1280*720` `720*1280` `960*960` `1088*832` `832*1088`；1080P `1920*1080` `1080*1920` `1440*1440` `1632*1248` `1248*1632`
+
+> **t2v/v2v 用 `size`、i2v 用 `resolution`** 是 Wan 家族的通用规律，三个版本都一样，最容易踩坑的地方。
+
+## 3. 上传要求
+
+`img_url`、`audio_url`、`reference_urls` 都以 `_url` / `_urls` 结尾 → 走 **`public-url` 模式**，需要公网 URL，本项目借用 KIE 上传服务。**未配置 KIE API Key 时图生视频与参考生视频不可用。**
+
+文档同时说明 `img_url` 接受 base64 data URL，但本项目的 `ppio-media.ts` 按字段名后缀判定为 `public-url`，不会走内联路径。
+
+## 4. 适配要点
+
+- `shot_type` 的默认值按变体不同（t2v/i2v 是 `multi`，v2v 是 `single`），不能写成统一默认值。
+- `duration` 合法集合按变体不同（v2v 无 15s），UI 需按当前模式过滤选项。
+- 计价是查表（分辨率 × 时长），不是线性按秒，与 Wan 2.7 完全不同。
+- 项目默认隐藏 `seed` 与负面提示词，按约定**不显示、不请求**。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文生视频 | https://ppio.com/docs/models/reference-wan2.6-t2v | 否 |
+| 图生视频 | https://ppio.com/docs/models/reference-wan2.6-i2v | 否 |
+| 参考生视频 | https://ppio.com/docs/models/reference-wan2.6-v2v | 否 |
+| 定价页（视频 tab） | https://ppio.com/pricing | 否 |

package/docs/model-adaptation/Wan-2.7/Wan-2.7_/346/264/276/346/254/247/344/272/221.md

@@ -1,122 +1,122 @@
-# Wan 2.7 · 派欧云 PPIO
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-30 |
-| 模态 | 视频 |
-| 供应商 | 派欧云 PPIO |
-| 平台路由 | `/v3/async/wan2.7-{t2v,i2v,r2v,videoedit}` |
-| 接口形态 | **异步任务** |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-供应商公共协议见 [供应商/派欧云.md](../供应商/派欧云.md)。
-
-## 1. 能力与价格
-
-| 变体 | 路由 | 价格 |
-|---|---|---|
-| 文生视频 | `/v3/async/wan2.7-t2v` | 720P ¥0.60/秒；1080P ¥1.00/秒 |
-| 图生视频 | `/v3/async/wan2.7-i2v` | 同上 |
-| 参考生视频 | `/v3/async/wan2.7-r2v` | 同上 |
-| 视频编辑 | `/v3/async/wan2.7-videoedit` | 同上 |
-
-**Wan 2.7 全系按秒计费**，与 Wan 2.5 / 2.6 的按视频条数计费不同。输出默认含音频。
-
-## 2. 请求体结构（与 2.5 / 2.6 不同）
-
-Wan 2.7 是**扁平结构**，没有 `{input, parameters}` 嵌套。Wan 2.5 与 2.6 是嵌套结构。**同家族不同版本不能共用 builder。**
-
-### 文生视频 `wan2.7-t2v`
-
-| 字段 | 类型 | 必填 | 默认 | 约束 |
-|---|---|---|---|---|
-| `prompt` | string | ✅ | — | 0–1500 |
-| `duration` | integer | | `5` | `[2, 15]` |
-| `size` | string | | `1920*1080` | 具体像素值，10 个枚举（720P/1080P 两档） |
-| `audio_url` | string | | — | wav/mp3，3–30 秒，≤15MB；不传则自动生成配乐/音效 |
-| `negative_prompt` | string | | — | 0–500 |
-| `seed` | integer | | — | `[0, 2147483647]` |
-| `watermark` | boolean | | `false` | |
-| `prompt_extend` | boolean | | `true` | |
-
-`size` 枚举：720P `1280*720` `720*1280` `960*960` `1088*832` `832*1088`；1080P `1920*1080` `1080*1920` `1440*1440` `1632*1248` `1248*1632`
-
-### 图生视频 `wan2.7-i2v`
-
-| 字段 | 类型 | 必填 | 默认 | 约束 |
-|---|---|---|---|---|
-| `image_url` | string | ✅※ | — | 与 `first_clip_url` **二选一至少一个**；[240, 8000]px，宽高比 1:8 ~ 8:1，≤20MB |
-| `first_clip_url` | string | ※ | — | 视频续写用，mp4/mov 2–10 秒，[240, 4096]px，≤100MB |
-| `last_frame_url` | string | | — | 尾帧 |
-| `driving_audio_url` | string | | — | 驱动音频，2–30 秒 ≤15MB，做口型同步 |
-| `prompt` | string | | — | 0–**5000**（比 t2v 宽松得多） |
-| `duration` | integer | | `5` | `[2, 15]` |
-| `resolution` | string | | `1080P` | `720P` / `1080P` |
-| `negative_prompt` | string | | — | 0–500 |
-| `seed` / `watermark` / `prompt_extend` | | | | 同 t2v |
-
-**注意 i2v 用 `resolution` 而不是 `size`**，这是 Wan 家族的通用规律（t2v 用具体像素的 `size`，i2v 用档位名的 `resolution`）。
-
-### 参考生视频 `wan2.7-r2v`
-
-| 字段 | 类型 | 必填 | 默认 | 约束 |
-|---|---|---|---|---|
-| `media` | **object[]** | ✅ | — | 长度 1–5，见下 |
-| `prompt` | string | ✅ | — | 0–1500，用 `character1` / `character2` 引用角色 |
-| `duration` | integer | | `5` | `[2, 10]` |
-| `size` | string | | `1920*1080` | 同 t2v |
-| `audio` | boolean | | `true` | **影响费用** |
-| `shot_type` | string | | `single` | `single` / `multi` |
-| `negative_prompt` / `seed` / `watermark` | | | | |
-
-`media` 每一项：
-
-```json
-{
-  "url": "...",
-  "type": "reference_image | reference_video | first_frame",
-  "reference_voice": "可选，音色克隆音频 MP3/WAV/FLAC 3-30s"
-}
-```
-
-数量约束：图片 0–5 个、视频 0–3 个、**总数 ≤ 5**。
-
-### 视频编辑 `wan2.7-videoedit`
-
-| 字段 | 类型 | 必填 | 默认 | 约束 |
-|---|---|---|---|---|
-| `video_url` | string | ✅ | — | mp4/mov，2–10 秒，[240, 4096]px，≤100MB |
-| `prompt` | string | | — | 0–5000，编辑指令 |
-| `duration` | integer | | `0` | **`0` = 沿用原视频时长**；范围 `[0, 10]`。此时估价读取宿主探测出的输入视频真实时长。 |
-| `resolution` | string | | `1080P` | `720P` / `1080P` |
-| `ratio` | string | | — | `16:9` / `9:16` / `1:1` / `4:3` / `3:4`；不传则近似原比例 |
-| `audio_setting` | string | | `auto` | `auto` / `origin` |
-| `reference_image_url` / `_2` / `_3` | string | | — | 最多 3 张，[240, 8000]px ≤20MB |
-| `negative_prompt` / `seed` / `watermark` / `prompt_extend` | | | | |
-
-## 3. 上传要求
-
-本模型几乎所有媒体字段都以 `_url` 结尾（`image_url`、`video_url`、`audio_url`、`first_clip_url`、`last_frame_url`、`driving_audio_url`、`reference_image_url`），r2v 的 `media[].url` 与 `media[].reference_voice` 也在白名单里 → **全部走 `public-url` 模式**，需要公网 URL。
-
-本项目借用 KIE 上传服务实现，因此 **Wan 2.7 的全部图生/参考生/视频编辑能力都依赖用户配置 KIE API Key**，只配 PPIO Key 会直接失败。这是 Wan 2.7 相比其他 PPIO 模型最重的前置依赖。
-
-`upload.ts` 里有针对 `/async/wan2.7-r2v` 的专门预处理（`preprocessPpioWan27ReferenceMediaObject`），按 `media[].type` 判断素材类型再上传。
-
-## 4. 适配要点
-
-- 四个变体的参数集合差异很大（`media` 数组 vs 扁平 URL 字段、`duration` 上限 15/10/10、`size` vs `resolution` vs `ratio`），建议用显式 `mode` 参数而不是自动路由。
-- `prompt` 长度上限在四个变体里是 1500 / 5000 / 1500 / 5000，不统一。
-- r2v 的 `audio` 字段影响费用，必须接入计价。
-- `videoedit` 的 `duration=0` 是有意义的默认值（沿用原时长），不能当成「未设置」处理。SDK 估价优先读取 `__videoDurationSeconds`，其次读取 `__totalVideoDurationSeconds`，并兼容旧字段 `__firstVideoDurationSeconds`；这些仅是运行时计价字段，不进入供应商请求。视频元数据不可读时才使用 5 秒兜底估计。
-- 项目默认隐藏 `seed` 与负面提示词，按约定**不显示、不请求**。
-
-## 5. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| 文生视频 | https://ppio.com/docs/models/reference-wan2.7-t2v | 否 |
-| 图生视频 | https://ppio.com/docs/models/reference-wan2.7-i2v | 否 |
-| 参考生视频 | https://ppio.com/docs/models/reference-wan2.7-r2v | 否 |
-| 视频编辑 | https://ppio.com/docs/models/reference-wan2.7-videoedit | 否 |
-| 定价页（视频 tab） | https://ppio.com/pricing | 否 |
+# Wan 2.7 · 派欧云 PPIO
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 视频 |
+| 供应商 | 派欧云 PPIO |
+| 平台路由 | `/v3/async/wan2.7-{t2v,i2v,r2v,videoedit}` |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+供应商公共协议见 [供应商/派欧云.md](../供应商/派欧云.md)。
+
+## 1. 能力与价格
+
+| 变体 | 路由 | 价格 |
+|---|---|---|
+| 文生视频 | `/v3/async/wan2.7-t2v` | 720P ¥0.60/秒；1080P ¥1.00/秒 |
+| 图生视频 | `/v3/async/wan2.7-i2v` | 同上 |
+| 参考生视频 | `/v3/async/wan2.7-r2v` | 同上 |
+| 视频编辑 | `/v3/async/wan2.7-videoedit` | 同上 |
+
+**Wan 2.7 全系按秒计费**，与 Wan 2.5 / 2.6 的按视频条数计费不同。输出默认含音频。
+
+## 2. 请求体结构（与 2.5 / 2.6 不同）
+
+Wan 2.7 是**扁平结构**，没有 `{input, parameters}` 嵌套。Wan 2.5 与 2.6 是嵌套结构。**同家族不同版本不能共用 builder。**
+
+### 文生视频 `wan2.7-t2v`
+
+| 字段 | 类型 | 必填 | 默认 | 约束 |
+|---|---|---|---|---|
+| `prompt` | string | ✅ | — | 0–1500 |
+| `duration` | integer | | `5` | `[2, 15]` |
+| `size` | string | | `1920*1080` | 具体像素值，10 个枚举（720P/1080P 两档） |
+| `audio_url` | string | | — | wav/mp3，3–30 秒，≤15MB；不传则自动生成配乐/音效 |
+| `negative_prompt` | string | | — | 0–500 |
+| `seed` | integer | | — | `[0, 2147483647]` |
+| `watermark` | boolean | | `false` | |
+| `prompt_extend` | boolean | | `true` | |
+
+`size` 枚举：720P `1280*720` `720*1280` `960*960` `1088*832` `832*1088`；1080P `1920*1080` `1080*1920` `1440*1440` `1632*1248` `1248*1632`
+
+### 图生视频 `wan2.7-i2v`
+
+| 字段 | 类型 | 必填 | 默认 | 约束 |
+|---|---|---|---|---|
+| `image_url` | string | ✅※ | — | 与 `first_clip_url` **二选一至少一个**；[240, 8000]px，宽高比 1:8 ~ 8:1，≤20MB |
+| `first_clip_url` | string | ※ | — | 视频续写用，mp4/mov 2–10 秒，[240, 4096]px，≤100MB |
+| `last_frame_url` | string | | — | 尾帧 |
+| `driving_audio_url` | string | | — | 驱动音频，2–30 秒 ≤15MB，做口型同步 |
+| `prompt` | string | | — | 0–**5000**（比 t2v 宽松得多） |
+| `duration` | integer | | `5` | `[2, 15]` |
+| `resolution` | string | | `1080P` | `720P` / `1080P` |
+| `negative_prompt` | string | | — | 0–500 |
+| `seed` / `watermark` / `prompt_extend` | | | | 同 t2v |
+
+**注意 i2v 用 `resolution` 而不是 `size`**，这是 Wan 家族的通用规律（t2v 用具体像素的 `size`，i2v 用档位名的 `resolution`）。
+
+### 参考生视频 `wan2.7-r2v`
+
+| 字段 | 类型 | 必填 | 默认 | 约束 |
+|---|---|---|---|---|
+| `media` | **object[]** | ✅ | — | 长度 1–5，见下 |
+| `prompt` | string | ✅ | — | 0–1500，用 `character1` / `character2` 引用角色 |
+| `duration` | integer | | `5` | `[2, 10]` |
+| `size` | string | | `1920*1080` | 同 t2v |
+| `audio` | boolean | | `true` | **影响费用** |
+| `shot_type` | string | | `single` | `single` / `multi` |
+| `negative_prompt` / `seed` / `watermark` | | | | |
+
+`media` 每一项：
+
+```json
+{
+  "url": "...",
+  "type": "reference_image | reference_video | first_frame",
+  "reference_voice": "可选，音色克隆音频 MP3/WAV/FLAC 3-30s"
+}
+```
+
+数量约束：图片 0–5 个、视频 0–3 个、**总数 ≤ 5**。
+
+### 视频编辑 `wan2.7-videoedit`
+
+| 字段 | 类型 | 必填 | 默认 | 约束 |
+|---|---|---|---|---|
+| `video_url` | string | ✅ | — | mp4/mov，2–10 秒，[240, 4096]px，≤100MB |
+| `prompt` | string | | — | 0–5000，编辑指令 |
+| `duration` | integer | | `0` | **`0` = 沿用原视频时长**；范围 `[0, 10]`。此时估价读取宿主探测出的输入视频真实时长。 |
+| `resolution` | string | | `1080P` | `720P` / `1080P` |
+| `ratio` | string | | — | `16:9` / `9:16` / `1:1` / `4:3` / `3:4`；不传则近似原比例 |
+| `audio_setting` | string | | `auto` | `auto` / `origin` |
+| `reference_image_url` / `_2` / `_3` | string | | — | 最多 3 张，[240, 8000]px ≤20MB |
+| `negative_prompt` / `seed` / `watermark` / `prompt_extend` | | | | |
+
+## 3. 上传要求
+
+本模型几乎所有媒体字段都以 `_url` 结尾（`image_url`、`video_url`、`audio_url`、`first_clip_url`、`last_frame_url`、`driving_audio_url`、`reference_image_url`），r2v 的 `media[].url` 与 `media[].reference_voice` 也在白名单里 → **全部走 `public-url` 模式**，需要公网 URL。
+
+本项目借用 KIE 上传服务实现，因此 **Wan 2.7 的全部图生/参考生/视频编辑能力都依赖用户配置 KIE API Key**，只配 PPIO Key 会直接失败。这是 Wan 2.7 相比其他 PPIO 模型最重的前置依赖。
+
+`upload.ts` 里有针对 `/async/wan2.7-r2v` 的专门预处理（`preprocessPpioWan27ReferenceMediaObject`），按 `media[].type` 判断素材类型再上传。
+
+## 4. 适配要点
+
+- 四个变体的参数集合差异很大（`media` 数组 vs 扁平 URL 字段、`duration` 上限 15/10/10、`size` vs `resolution` vs `ratio`），建议用显式 `mode` 参数而不是自动路由。
+- `prompt` 长度上限在四个变体里是 1500 / 5000 / 1500 / 5000，不统一。
+- r2v 的 `audio` 字段影响费用，必须接入计价。
+- `videoedit` 的 `duration=0` 是有意义的默认值（沿用原时长），不能当成「未设置」处理。SDK 估价优先读取 `__videoDurationSeconds`，其次读取 `__totalVideoDurationSeconds`，并兼容旧字段 `__firstVideoDurationSeconds`；这些仅是运行时计价字段，不进入供应商请求。视频元数据不可读时才使用 5 秒兜底估计。
+- 项目默认隐藏 `seed` 与负面提示词，按约定**不显示、不请求**。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文生视频 | https://ppio.com/docs/models/reference-wan2.7-t2v | 否 |
+| 图生视频 | https://ppio.com/docs/models/reference-wan2.7-i2v | 否 |
+| 参考生视频 | https://ppio.com/docs/models/reference-wan2.7-r2v | 否 |
+| 视频编辑 | https://ppio.com/docs/models/reference-wan2.7-videoedit | 否 |
+| 定价页（视频 tab） | https://ppio.com/pricing | 否 |