@henjicc/ai-sdk 0.2.8 → 0.4.0

package/docs/model-adaptation/Hailuo-02/Hailuo-02_KIE.md

@@ -1,56 +1,56 @@
-# Hailuo 02 · KIE
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-30 |
-| 模态 | 视频 |
-| 供应商 | KIE.ai |
-| 平台模型 ID | `hailuo/02-text-to-video-standard`、`hailuo/02-image-to-video-standard`、`hailuo/02-text-to-video-pro`、`hailuo/02-image-to-video-pro` |
-| 接口形态 | `POST /api/v1/jobs/createTask` + `GET /api/v1/jobs/recordInfo` |
-| 价格可见性 | 公开，无需登录 |
-
-## 1. 路由与规格
-
-| 输入 | 规格 | 模型 |
-|---|---|---|
-| 无图 | 6/10 秒、768P | `hailuo/02-text-to-video-standard` |
-| 1–2 张图 | 6/10 秒、512P/768P | `hailuo/02-image-to-video-standard` |
-| 无图 | 6 秒、1080P | `hailuo/02-text-to-video-pro` |
-| 1 张图 | 6 秒、1080P | `hailuo/02-image-to-video-pro` |
-
-约束：
-
-- 512P 价格只有图生视频 Standard 分支；文生视频 Standard 固定按 768P 计价，请求也不发送 `resolution`。
-- 1080P 只有 Pro 6 秒档；不存在 `10 秒 + 1080P`。遇到历史参数组合时，运行时必须回收到 10 秒 768P，不得带着 1080P 下发或估价。
-- 首尾帧仍走 Standard 图生视频端点，第二张图映射为 `end_image_url`。
-
-## 2. 价格
-
-KIE 公开定价使用积分，`1 Credit = $0.005`。
-
-| 组合 | Credits | 美元价格 |
-|---|---:|---:|
-| Standard 文生 / 图生，6s 768P | 30 / 条 | $0.15 |
-| Standard 文生 / 图生，10s 768P | 50 / 条 | $0.25 |
-| Standard 图生，6s 512P | 12 / 条 | $0.06 |
-| Standard 图生，10s 512P | 20 / 条 | $0.10 |
-| Pro 文生 / 图生，6s 1080P | 57 / 条 | $0.285 |
-
-SDK 应按实际路由计价：文生视频即使收到残留的 `512P` 参数，也必须按 768P 计价。
-
-## 3. 项目策略
-
-- 模型 schema 保留通用时长和分辨率控件，非法的 10s 1080P 会被联动回收到 768P。
-- builder 和 pricing 使用同一套有效规格归一化，防止 UI、旧工程或外部 SDK 消费方绕过联动后发生低估。
-- 这些价格以美元记录；人民币展示由宿主使用用户汇率换算。
-
-## 4. 原始链接索引
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| Standard 文生视频 | https://docs.kie.ai/cn/market/hailuo/02-text-to-video-standard | 否 |
-| Standard 图生视频 | https://docs.kie.ai/cn/market/hailuo/02-image-to-video-standard | 否 |
-| Pro 文生视频 | https://docs.kie.ai/cn/market/hailuo/02-text-to-video-pro | 否 |
-| Pro 图生视频 | https://docs.kie.ai/cn/market/hailuo/02-image-to-video-pro | 否 |
-| 模型专页 | https://kie.ai/hailuo-api | 否 |
-| 当前定价 | https://kie.ai/pricing | 否 |
+# Hailuo 02 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 视频 |
+| 供应商 | KIE.ai |
+| 平台模型 ID | `hailuo/02-text-to-video-standard`、`hailuo/02-image-to-video-standard`、`hailuo/02-text-to-video-pro`、`hailuo/02-image-to-video-pro` |
+| 接口形态 | `POST /api/v1/jobs/createTask` + `GET /api/v1/jobs/recordInfo` |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 路由与规格
+
+| 输入 | 规格 | 模型 |
+|---|---|---|
+| 无图 | 6/10 秒、768P | `hailuo/02-text-to-video-standard` |
+| 1–2 张图 | 6/10 秒、512P/768P | `hailuo/02-image-to-video-standard` |
+| 无图 | 6 秒、1080P | `hailuo/02-text-to-video-pro` |
+| 1 张图 | 6 秒、1080P | `hailuo/02-image-to-video-pro` |
+
+约束：
+
+- 512P 价格只有图生视频 Standard 分支；文生视频 Standard 固定按 768P 计价，请求也不发送 `resolution`。
+- 1080P 只有 Pro 6 秒档；不存在 `10 秒 + 1080P`。遇到历史参数组合时，运行时必须回收到 10 秒 768P，不得带着 1080P 下发或估价。
+- 首尾帧仍走 Standard 图生视频端点，第二张图映射为 `end_image_url`。
+
+## 2. 价格
+
+KIE 公开定价使用积分，`1 Credit = $0.005`。
+
+| 组合 | Credits | 美元价格 |
+|---|---:|---:|
+| Standard 文生 / 图生，6s 768P | 30 / 条 | $0.15 |
+| Standard 文生 / 图生，10s 768P | 50 / 条 | $0.25 |
+| Standard 图生，6s 512P | 12 / 条 | $0.06 |
+| Standard 图生，10s 512P | 20 / 条 | $0.10 |
+| Pro 文生 / 图生，6s 1080P | 57 / 条 | $0.285 |
+
+SDK 应按实际路由计价：文生视频即使收到残留的 `512P` 参数，也必须按 768P 计价。
+
+## 3. 项目策略
+
+- 模型 schema 保留通用时长和分辨率控件，非法的 10s 1080P 会被联动回收到 768P。
+- builder 和 pricing 使用同一套有效规格归一化，防止 UI、旧工程或外部 SDK 消费方绕过联动后发生低估。
+- 这些价格以美元记录；人民币展示由宿主使用用户汇率换算。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| Standard 文生视频 | https://docs.kie.ai/cn/market/hailuo/02-text-to-video-standard | 否 |
+| Standard 图生视频 | https://docs.kie.ai/cn/market/hailuo/02-image-to-video-standard | 否 |
+| Pro 文生视频 | https://docs.kie.ai/cn/market/hailuo/02-text-to-video-pro | 否 |
+| Pro 图生视频 | https://docs.kie.ai/cn/market/hailuo/02-image-to-video-pro | 否 |
+| 模型专页 | https://kie.ai/hailuo-api | 否 |
+| 当前定价 | https://kie.ai/pricing | 否 |

package/docs/model-adaptation/Hailuo-2.3/Hailuo-2.3_Fal.md

@@ -1,88 +1,88 @@
-# MiniMax Hailuo 2.3 · Fal
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-30 |
-| 模态 | 视频 |
-| 供应商 | fal.ai（聚合平台） |
-| 平台模型 ID | `fal-ai/minimax/hailuo-2.3/{standard,pro}/{text-to-video,image-to-video}`、`fal-ai/minimax/hailuo-2.3-fast/{standard,pro}/image-to-video` |
-| 接口形态 | 队列异步（推荐）或同步直连 |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-## 1. 接入协议（Fal 通用）
-
-- **鉴权**：`Authorization: Key $FAL_KEY`
-- **同步**：`POST https://fal.run/<endpoint-id>`
-- **队列提交**：`POST https://queue.fal.run/<endpoint-id>`
-- **查询与结果**：`GET .../requests/{id}/status`（`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`）、`GET .../requests/{id}`
-- **权威 schema 与价格**：`https://fal.ai/models/<endpoint-id>/llms.txt`
-
-## 2. 路由矩阵
-
-| 输入与模式 | 档位 | endpoint ID | 时长 |
-|---|---|---|---|
-| 无图片；`fast` 开关无效 | Standard | `fal-ai/minimax/hailuo-2.3/standard/text-to-video` | 6 / 10 秒 |
-| 无图片；`fast` 开关无效 | Pro | `fal-ai/minimax/hailuo-2.3/pro/text-to-video` | 固定 6 秒 |
-| 有图片，关闭 `fast` | Standard | `fal-ai/minimax/hailuo-2.3/standard/image-to-video` | 6 / 10 秒 |
-| 有图片，关闭 `fast` | Pro | `fal-ai/minimax/hailuo-2.3/pro/image-to-video` | 固定 6 秒 |
-| 有图片，开启 `fast` | Standard | `fal-ai/minimax/hailuo-2.3-fast/standard/image-to-video` | 6 / 10 秒 |
-| 有图片，开启 `fast` | Pro | `fal-ai/minimax/hailuo-2.3-fast/pro/image-to-video` | 固定 6 秒 |
-
-**路由硬规则：没有图片时始终走 non-fast 文生视频端点。** `fast` 只存在于图生视频；不能因为界面开关为真，就把无图请求定价成 Fast，也不能拼出不存在的 Fast 文生视频路径。
-
-## 3. 请求参数
-
-| 字段 | 类型 | 适用端点 | 说明 |
-|---|---|---|---|
-| `prompt` | string | 全部 | 视频描述 |
-| `duration` | string / integer | Standard | `6` / `10`；Pro 端点固定 6 秒，不发送该字段 |
-| `prompt_optimizer` | boolean | 全部 | 是否优化提示词，默认开启 |
-| `image_url` | string | 图生视频 | 首帧图 URL；图生视频端点必需 |
-
-每次最多使用 1 张输入图。项目默认不展示、不请求 `seed`、负面提示词和 `output_format`。
-
-## 4. 响应结构
-
-```json
-{
-  "video": {
-    "url": "https://v3b.fal.media/files/.../output.mp4"
-  }
-}
-```
-
-生成结果沿用 Fal 通用 `video.url` 解析、队列轮询、取消与 Fal CDN 上传链路。
-
-## 5. 价格
-
-来源：六个实际端点的实时 `llms.txt`（2026-08-30 读取）。Fal 按**每条生成视频**计费：
-
-| 路由 | 6 秒 | 10 秒 |
-|---|---:|---:|
-| non-fast Standard · 文生 / 图生 | **$0.28 / 条** | **$0.56 / 条** |
-| non-fast Pro · 文生 / 图生 | **$0.49 / 条** | 不支持 |
-| Fast Standard · 仅图生 | **$0.19 / 条** | **$0.32 / 条** |
-| Fast Pro · 仅图生 | **$0.33 / 条** | 不支持 |
-
-计价必须先按“是否真的有图片”确定能否进入 Fast，再按 Standard / Pro 和时长选价。无图时即使 `fast=true`，仍使用 non-fast 的 `$0.28/$0.56` 或 `$0.49`。
-
-## 6. 适配要点
-
-- Fast 的正确路径是 `hailuo-2.3-fast/{standard,pro}/image-to-video`，不是 `hailuo-2.3/fast/...`。
-- Standard 支持 6 / 10 秒；Pro 固定 6 秒，不能让 10 秒的界面值参与 Pro 计价。
-- Fast 只有图生视频，路由与计价都必须读取三种实时图片字段：生成提交的 `uploadedFilePaths`、画布的 `images`、对话/工具面板的 `uploadedImages`。
-- 模型的 Standard / Pro、Fast / non-fast 是 endpoint 级差异，不应在宿主层按模型 ID 另写请求或价格分支。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| non-fast Standard 文生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3/standard/text-to-video/llms.txt | 否 |
-| non-fast Standard 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3/standard/image-to-video/llms.txt | 否 |
-| non-fast Pro 文生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3/pro/text-to-video/llms.txt | 否 |
-| non-fast Pro 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3/pro/image-to-video/llms.txt | 否 |
-| Fast Standard 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3-fast/standard/image-to-video/llms.txt | 否 |
-| Fast Pro 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3-fast/pro/image-to-video/llms.txt | 否 |
-| Fal 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
-| API Key 创建 | https://fal.ai/dashboard/keys | **是** |
+# MiniMax Hailuo 2.3 · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 视频 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `fal-ai/minimax/hailuo-2.3/{standard,pro}/{text-to-video,image-to-video}`、`fal-ai/minimax/hailuo-2.3-fast/{standard,pro}/image-to-video` |
+| 接口形态 | 队列异步（推荐）或同步直连 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议（Fal 通用）
+
+- **鉴权**：`Authorization: Key $FAL_KEY`
+- **同步**：`POST https://fal.run/<endpoint-id>`
+- **队列提交**：`POST https://queue.fal.run/<endpoint-id>`
+- **查询与结果**：`GET .../requests/{id}/status`（`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`）、`GET .../requests/{id}`
+- **权威 schema 与价格**：`https://fal.ai/models/<endpoint-id>/llms.txt`
+
+## 2. 路由矩阵
+
+| 输入与模式 | 档位 | endpoint ID | 时长 |
+|---|---|---|---|
+| 无图片；`fast` 开关无效 | Standard | `fal-ai/minimax/hailuo-2.3/standard/text-to-video` | 6 / 10 秒 |
+| 无图片；`fast` 开关无效 | Pro | `fal-ai/minimax/hailuo-2.3/pro/text-to-video` | 固定 6 秒 |
+| 有图片，关闭 `fast` | Standard | `fal-ai/minimax/hailuo-2.3/standard/image-to-video` | 6 / 10 秒 |
+| 有图片，关闭 `fast` | Pro | `fal-ai/minimax/hailuo-2.3/pro/image-to-video` | 固定 6 秒 |
+| 有图片，开启 `fast` | Standard | `fal-ai/minimax/hailuo-2.3-fast/standard/image-to-video` | 6 / 10 秒 |
+| 有图片，开启 `fast` | Pro | `fal-ai/minimax/hailuo-2.3-fast/pro/image-to-video` | 固定 6 秒 |
+
+**路由硬规则：没有图片时始终走 non-fast 文生视频端点。** `fast` 只存在于图生视频；不能因为界面开关为真，就把无图请求定价成 Fast，也不能拼出不存在的 Fast 文生视频路径。
+
+## 3. 请求参数
+
+| 字段 | 类型 | 适用端点 | 说明 |
+|---|---|---|---|
+| `prompt` | string | 全部 | 视频描述 |
+| `duration` | string / integer | Standard | `6` / `10`；Pro 端点固定 6 秒，不发送该字段 |
+| `prompt_optimizer` | boolean | 全部 | 是否优化提示词，默认开启 |
+| `image_url` | string | 图生视频 | 首帧图 URL；图生视频端点必需 |
+
+每次最多使用 1 张输入图。项目默认不展示、不请求 `seed`、负面提示词和 `output_format`。
+
+## 4. 响应结构
+
+```json
+{
+  "video": {
+    "url": "https://v3b.fal.media/files/.../output.mp4"
+  }
+}
+```
+
+生成结果沿用 Fal 通用 `video.url` 解析、队列轮询、取消与 Fal CDN 上传链路。
+
+## 5. 价格
+
+来源：六个实际端点的实时 `llms.txt`（2026-08-30 读取）。Fal 按**每条生成视频**计费：
+
+| 路由 | 6 秒 | 10 秒 |
+|---|---:|---:|
+| non-fast Standard · 文生 / 图生 | **$0.28 / 条** | **$0.56 / 条** |
+| non-fast Pro · 文生 / 图生 | **$0.49 / 条** | 不支持 |
+| Fast Standard · 仅图生 | **$0.19 / 条** | **$0.32 / 条** |
+| Fast Pro · 仅图生 | **$0.33 / 条** | 不支持 |
+
+计价必须先按“是否真的有图片”确定能否进入 Fast，再按 Standard / Pro 和时长选价。无图时即使 `fast=true`，仍使用 non-fast 的 `$0.28/$0.56` 或 `$0.49`。
+
+## 6. 适配要点
+
+- Fast 的正确路径是 `hailuo-2.3-fast/{standard,pro}/image-to-video`，不是 `hailuo-2.3/fast/...`。
+- Standard 支持 6 / 10 秒；Pro 固定 6 秒，不能让 10 秒的界面值参与 Pro 计价。
+- Fast 只有图生视频，路由与计价都必须读取三种实时图片字段：生成提交的 `uploadedFilePaths`、画布的 `images`、对话/工具面板的 `uploadedImages`。
+- 模型的 Standard / Pro、Fast / non-fast 是 endpoint 级差异，不应在宿主层按模型 ID 另写请求或价格分支。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| non-fast Standard 文生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3/standard/text-to-video/llms.txt | 否 |
+| non-fast Standard 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3/standard/image-to-video/llms.txt | 否 |
+| non-fast Pro 文生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3/pro/text-to-video/llms.txt | 否 |
+| non-fast Pro 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3/pro/image-to-video/llms.txt | 否 |
+| Fast Standard 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3-fast/standard/image-to-video/llms.txt | 否 |
+| Fast Pro 图生视频 schema + 价格 | https://fal.ai/models/fal-ai/minimax/hailuo-2.3-fast/pro/image-to-video/llms.txt | 否 |
+| Fal 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
+| API Key 创建 | https://fal.ai/dashboard/keys | **是** |

package/docs/model-adaptation/Hailuo-2.3/Hailuo-2.3_KIE.md

@@ -1,51 +1,51 @@
-# Hailuo 2.3 · KIE
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-30 |
-| 模态 | 图生视频 |
-| 供应商 | KIE.ai |
-| 平台模型 ID | `hailuo/2-3-image-to-video-standard`、`hailuo/2-3-image-to-video-pro` |
-| 接口形态 | `POST /api/v1/jobs/createTask` + `GET /api/v1/jobs/recordInfo` |
-| 价格可见性 | 公开，无需登录 |
-
-## 1. 请求和合法组合
-
-两个端点都要求 1 张输入图片，提交字段为 `prompt`、`image_url`、`duration`、`resolution`。
-
-| 模式 | 6s 768P | 10s 768P | 6s 1080P | 10s 1080P |
-|---|---|---|---|---|
-| Standard | 支持 | 支持 | 支持 | **不支持** |
-| Pro | 支持 | 支持 | 支持 | **不支持** |
-
-`10 秒 + 1080P` 不是 KIE 公开的价格/请求组合。生成页联动会将它回收到 10 秒 768P，SDK builder 和 pricing 也必须做相同归一化。
-
-## 2. 价格
-
-KIE 定价页的精确积分换算为 `1 Credit = $0.005`。
-
-| 模式 | 组合 | Credits | 美元价格 |
-|---|---|---:|---:|
-| Standard | 6s 768P | 30 / 条 | $0.15 |
-| Standard | 10s 768P | 50 / 条 | $0.25 |
-| Standard | 6s 1080P | 50 / 条 | $0.25 |
-| Pro | 6s 768P | 45 / 条 | $0.225 |
-| Pro | 10s 768P | 90 / 条 | $0.45 |
-| Pro | 6s 1080P | 80 / 条 | $0.40 |
-
-模型营销专页将部分精确价格显示为 `$0.26 / $0.22 / $0.39`，与同页 Credits 和当前定价数据不一致。SDK 以当前定价表的 Credits 及其精确美元值为准。
-
-## 3. 项目策略
-
-- 价格表只保留六个官方合法 key，不得把未知 key fallback 到 Standard 6s 768P。
-- 对残留的 `10s + 1080P` 参数，builder 和 pricing 统一回收到 `10s + 768P`。
-- 这些价格以美元记录；人民币展示由宿主使用用户汇率换算。
-
-## 4. 原始链接索引
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| Standard 图生视频 | https://docs.kie.ai/cn/market/hailuo/2-3-image-to-video-standard | 否 |
-| Pro 图生视频 | https://docs.kie.ai/cn/market/hailuo/2-3-image-to-video-pro | 否 |
-| 模型专页 | https://kie.ai/hailuo-2-3 | 否 |
-| 当前定价 | https://kie.ai/pricing | 否 |
+# Hailuo 2.3 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 图生视频 |
+| 供应商 | KIE.ai |
+| 平台模型 ID | `hailuo/2-3-image-to-video-standard`、`hailuo/2-3-image-to-video-pro` |
+| 接口形态 | `POST /api/v1/jobs/createTask` + `GET /api/v1/jobs/recordInfo` |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 请求和合法组合
+
+两个端点都要求 1 张输入图片，提交字段为 `prompt`、`image_url`、`duration`、`resolution`。
+
+| 模式 | 6s 768P | 10s 768P | 6s 1080P | 10s 1080P |
+|---|---|---|---|---|
+| Standard | 支持 | 支持 | 支持 | **不支持** |
+| Pro | 支持 | 支持 | 支持 | **不支持** |
+
+`10 秒 + 1080P` 不是 KIE 公开的价格/请求组合。生成页联动会将它回收到 10 秒 768P，SDK builder 和 pricing 也必须做相同归一化。
+
+## 2. 价格
+
+KIE 定价页的精确积分换算为 `1 Credit = $0.005`。
+
+| 模式 | 组合 | Credits | 美元价格 |
+|---|---|---:|---:|
+| Standard | 6s 768P | 30 / 条 | $0.15 |
+| Standard | 10s 768P | 50 / 条 | $0.25 |
+| Standard | 6s 1080P | 50 / 条 | $0.25 |
+| Pro | 6s 768P | 45 / 条 | $0.225 |
+| Pro | 10s 768P | 90 / 条 | $0.45 |
+| Pro | 6s 1080P | 80 / 条 | $0.40 |
+
+模型营销专页将部分精确价格显示为 `$0.26 / $0.22 / $0.39`，与同页 Credits 和当前定价数据不一致。SDK 以当前定价表的 Credits 及其精确美元值为准。
+
+## 3. 项目策略
+
+- 价格表只保留六个官方合法 key，不得把未知 key fallback 到 Standard 6s 768P。
+- 对残留的 `10s + 1080P` 参数，builder 和 pricing 统一回收到 `10s + 768P`。
+- 这些价格以美元记录；人民币展示由宿主使用用户汇率换算。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| Standard 图生视频 | https://docs.kie.ai/cn/market/hailuo/2-3-image-to-video-standard | 否 |
+| Pro 图生视频 | https://docs.kie.ai/cn/market/hailuo/2-3-image-to-video-pro | 否 |
+| 模型专页 | https://kie.ai/hailuo-2-3 | 否 |
+| 当前定价 | https://kie.ai/pricing | 否 |

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

@@ -1,70 +1,70 @@
-# MiniMax Hailuo 2.3 · 派欧云 PPIO
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-26 |
-| 模态 | 视频 |
-| 供应商 | 派欧云 PPIO |
-| 平台路由 | `/v3/async/minimax-hailuo-2.3-{t2v,i2v,fast-i2v}` |
-| 接口形态 | **异步任务** |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-供应商公共协议见 [供应商/派欧云.md](../供应商/派欧云.md)。
-
-## 1. 能力与价格
-
-**按视频条数计费**：
-
-| 变体 | 路由 | 6s/768P | 10s/768P | 6s/1080P |
-|---|---|---|---|---|
-| 文生视频 | `/v3/async/minimax-hailuo-2.3-t2v` | ¥2 | ¥4 | ¥3.5 |
-| 图生视频 | `/v3/async/minimax-hailuo-2.3-i2v` | ¥2 | ¥4 | ¥3.5 |
-| **Fast** 图生视频 | `/v3/async/minimax-hailuo-2.3-fast-i2v` | ¥1.35 | ¥2.25 | ¥2.3 |
-
-**10 秒档只支持 768P，没有 10s/1080P 组合。** Fast 模式只有图生视频，没有文生视频。
-
-## 2. 请求参数
-
-| 字段 | 类型 | 必填 | 默认 | 约束 |
-|---|---|---|---|---|
-| `prompt` | string | ✅ | — | 1–2000，**支持运镜指令，见下** |
-| `image` | string | ✅（i2v / fast-i2v） | — | 公网 URL 或 `data:image/jpeg;base64,...` |
-| `duration` | integer | | `6` | 枚举 `6` / `10` |
-| `resolution` | string | | `768P` | **6s 支持 `768P`/`1080P`；10s 仅 `768P`** |
-| `enable_prompt_expansion` | boolean | | `true` | |
-| `fast_pretreatment` | boolean | | `false` | **fast-i2v 变体没有这个字段** |
-| `aigc_watermark` | boolean | | `false` | |
-
-### 运镜指令（写在 prompt 里）
-
-t2v 与 i2v 的 `prompt` 支持 15 种方括号运镜指令：
-
-```
-[左移] [右移] [左摇] [右摇] [推进] [拉远] [上升] [下降]
-[上摇] [下摇] [变焦推近] [变焦拉远] [晃动] [跟随] [固定]
-```
-
-同一组 `[]` 内组合建议 ≤ 3 个。
-
-> **fast-i2v 的文档里没有写运镜指令说明**，且没有 `fast_pretreatment` 字段——接入时不要假设 fast 变体与标准变体完全等价。
-
-## 3. 上传要求
-
-`image` 字段名不以 `_url` 结尾 → 走默认 **`data-uri` 模式**内联，**不依赖 KIE API Key**。这是 PPIO 视频模型里少见的无外部依赖的情况。
-
-## 4. 适配要点
-
-- `resolution` 与 `duration` 有互斥约束（10s 不能选 1080P），需要用 linkage 的 `filterOptions` + `autoSwitch` 表达，不能只在 builder 里静默回落。
-- Fast 模式只在图生视频下存在，文生视频时该开关应隐藏。
-- 计价维度是 `duration × resolution × 是否 fast`，三个维度都要读。
-- 项目默认隐藏 `seed` 与负面提示词：本模型接口**没有**这两个字段，无需处理。
-
-## 5. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| 文生视频 | https://ppio.com/docs/models/reference-minimax-hailuo-2.3-t2v | 否 |
-| 图生视频 | https://ppio.com/docs/models/reference-minimax-hailuo-2.3-i2v | 否 |
-| Fast 图生视频 | https://ppio.com/docs/models/reference-minimax-hailuo-2.3-fast-i2v | 否 |
-| 定价页（视频 tab） | https://ppio.com/pricing | 否 |
+# MiniMax Hailuo 2.3 · 派欧云 PPIO
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-26 |
+| 模态 | 视频 |
+| 供应商 | 派欧云 PPIO |
+| 平台路由 | `/v3/async/minimax-hailuo-2.3-{t2v,i2v,fast-i2v}` |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+供应商公共协议见 [供应商/派欧云.md](../供应商/派欧云.md)。
+
+## 1. 能力与价格
+
+**按视频条数计费**：
+
+| 变体 | 路由 | 6s/768P | 10s/768P | 6s/1080P |
+|---|---|---|---|---|
+| 文生视频 | `/v3/async/minimax-hailuo-2.3-t2v` | ¥2 | ¥4 | ¥3.5 |
+| 图生视频 | `/v3/async/minimax-hailuo-2.3-i2v` | ¥2 | ¥4 | ¥3.5 |
+| **Fast** 图生视频 | `/v3/async/minimax-hailuo-2.3-fast-i2v` | ¥1.35 | ¥2.25 | ¥2.3 |
+
+**10 秒档只支持 768P，没有 10s/1080P 组合。** Fast 模式只有图生视频，没有文生视频。
+
+## 2. 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 约束 |
+|---|---|---|---|---|
+| `prompt` | string | ✅ | — | 1–2000，**支持运镜指令，见下** |
+| `image` | string | ✅（i2v / fast-i2v） | — | 公网 URL 或 `data:image/jpeg;base64,...` |
+| `duration` | integer | | `6` | 枚举 `6` / `10` |
+| `resolution` | string | | `768P` | **6s 支持 `768P`/`1080P`；10s 仅 `768P`** |
+| `enable_prompt_expansion` | boolean | | `true` | |
+| `fast_pretreatment` | boolean | | `false` | **fast-i2v 变体没有这个字段** |
+| `aigc_watermark` | boolean | | `false` | |
+
+### 运镜指令（写在 prompt 里）
+
+t2v 与 i2v 的 `prompt` 支持 15 种方括号运镜指令：
+
+```
+[左移] [右移] [左摇] [右摇] [推进] [拉远] [上升] [下降]
+[上摇] [下摇] [变焦推近] [变焦拉远] [晃动] [跟随] [固定]
+```
+
+同一组 `[]` 内组合建议 ≤ 3 个。
+
+> **fast-i2v 的文档里没有写运镜指令说明**，且没有 `fast_pretreatment` 字段——接入时不要假设 fast 变体与标准变体完全等价。
+
+## 3. 上传要求
+
+`image` 字段名不以 `_url` 结尾 → 走默认 **`data-uri` 模式**内联，**不依赖 KIE API Key**。这是 PPIO 视频模型里少见的无外部依赖的情况。
+
+## 4. 适配要点
+
+- `resolution` 与 `duration` 有互斥约束（10s 不能选 1080P），需要用 linkage 的 `filterOptions` + `autoSwitch` 表达，不能只在 builder 里静默回落。
+- Fast 模式只在图生视频下存在，文生视频时该开关应隐藏。
+- 计价维度是 `duration × resolution × 是否 fast`，三个维度都要读。
+- 项目默认隐藏 `seed` 与负面提示词：本模型接口**没有**这两个字段，无需处理。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文生视频 | https://ppio.com/docs/models/reference-minimax-hailuo-2.3-t2v | 否 |
+| 图生视频 | https://ppio.com/docs/models/reference-minimax-hailuo-2.3-i2v | 否 |
+| Fast 图生视频 | https://ppio.com/docs/models/reference-minimax-hailuo-2.3-fast-i2v | 否 |
+| 定价页（视频 tab） | https://ppio.com/pricing | 否 |