@henjicc/ai-sdk 0.9.0 → 0.10.0

package/dist/catalog/ppio/wan-2.7.model.js

@@ -1,373 +0,0 @@
-import { defineModel } from '../defineModel.js';
-import { resolveUploadedVideoDurationSeconds } from './mediaSources.js';
-const WAN27_SIZE_MAP = {
-    '16:9': { '720P': '1280*720', '1080P': '1920*1080' },
-    '9:16': { '720P': '720*1280', '1080P': '1080*1920' },
-    '1:1': { '720P': '960*960', '1080P': '1440*1440' },
-    '4:3': { '720P': '1088*832', '1080P': '1632*1248' },
-    '3:4': { '720P': '832*1088', '1080P': '1248*1632' }
-};
-const WAN27_EDIT_RATIO_MAP = {
-    '16:9': { '720P': '1280*720', '1080P': '1920*1080' },
-    '9:16': { '720P': '720*1280', '1080P': '1080*1920' },
-    '1:1': { '720P': '960*960', '1080P': '1440*1440' },
-    '4:3': { '720P': '1104*832', '1080P': '1648*1248' },
-    '3:4': { '720P': '832*1104', '1080P': '1248*1648' }
-};
-export const wan27Model = defineModel({
-    meta: {
-        id: 'ppio-wan-2.7',
-        canonicalModelId: 'wan-2.7',
-        seriesId: 'wan',
-        seriesRank: 2.7,
-        provider: 'ppio',
-        type: 'video',
-        tags: [
-            'text-to-video',
-            'image-to-video',
-            'start-end-frame',
-            'reference-mode',
-            'video-to-video',
-            'video-extension',
-            'supports-video-editing',
-            'supports-audio-generation',
-            'supports-audio-drive',
-            'supports-prompt-expansion',
-            'multi-mode-switch',
-            'mixed-upload-mode',
-            'provider-ppio'
-        ],
-        polling: {
-            interval: 3000,
-            maxAttempts: 120,
-            expectedAttempts: 50
-        }
-    },
-    inputLimits: {
-        images: { max: 2 },
-        videos: { max: 1 },
-        audios: { max: 1 },
-        rules: [
-            {
-                when: 'ppioWan27Mode === "text-image-to-video"',
-                images: { max: 2 },
-                videos: { max: 1 },
-                audios: { max: 1 }
-            },
-            {
-                when: 'ppioWan27Mode === "reference-to-video"',
-                images: { max: 5 },
-                videos: { max: 3 },
-                audios: { max: 0 }
-            },
-            {
-                when: 'ppioWan27Mode === "video-edit"',
-                images: { max: 3 },
-                videos: { exact: 1 },
-                audios: { max: 0 }
-            }
-        ]
-    },
-    requirements: [
-        {
-            id: 'wan-27-video-edit-video-required',
-            when: 'ppioWan27Mode === "video-edit"',
-            require: { videos: { exact: 1 } },
-            message: {
-                title: '视频必需',
-                message: '视频编辑模式需要上传 1 个待编辑视频',
-                type: 'warning'
-            }
-        }
-    ],
-    params: [
-        {
-            id: 'ppioWan27Mode',
-            type: 'dropdown',
-            order: 1,
-            valueType: 'string',
-            default: 'text-image-to-video',
-            options: [
-                { value: 'text-image-to-video' },
-                { value: 'reference-to-video' },
-                { value: 'video-edit' }
-            ],
-            apiField: 'mode'
-        },
-        {
-            id: 'ppioWan27AspectRatio',
-            type: 'dropdown',
-            order: 2,
-            valueType: 'string',
-            default: '16:9',
-            visible: {
-                condition: 'ppioWan27Mode === "text-image-to-video" && uploadedImages.length === 0 && uploadedVideos.length === 0',
-                reason: '仅无素材的文生视频通过 size 设置比例'
-            },
-            options: Object.keys(WAN27_SIZE_MAP).map((value) => ({ value })),
-            apiField: 'size'
-        },
-        {
-            id: 'ppioWan27EditRatio',
-            type: 'dropdown',
-            order: 3,
-            valueType: 'string',
-            default: 'auto',
-            visible: {
-                condition: 'ppioWan27Mode === "video-edit"',
-                reason: '视频编辑模式可选择输出比例，自动时沿用输入视频比例'
-            },
-            options: [
-                { value: 'auto' },
-                ...Object.keys(WAN27_EDIT_RATIO_MAP).map((value) => ({ value }))
-            ],
-            apiField: 'ratio'
-        },
-        {
-            id: 'ppioWan27Resolution',
-            type: 'dropdown',
-            order: 4,
-            valueType: 'string',
-            default: '1080P',
-            options: [
-                { value: '720P' },
-                { value: '1080P' }
-            ],
-            apiField: 'resolution'
-        },
-        {
-            id: 'ppioWan27Duration',
-            type: 'number',
-            order: 5,
-            valueType: 'number',
-            default: 5,
-            min: 2,
-            max: 15,
-            step: 1,
-            apiField: 'duration'
-        },
-        {
-            id: 'ppioWan27ShotType',
-            type: 'dropdown',
-            order: 6,
-            valueType: 'string',
-            default: 'single',
-            visible: {
-                condition: 'ppioWan27Mode === "reference-to-video"',
-                reason: '仅参考生视频支持镜头类型'
-            },
-            options: [
-                { value: 'single' },
-                { value: 'multi' }
-            ],
-            apiField: 'shot_type'
-        },
-        {
-            id: 'ppioWan27Audio',
-            type: 'switch',
-            order: 7,
-            valueType: 'boolean',
-            default: true,
-            visible: {
-                condition: 'ppioWan27Mode === "reference-to-video"',
-                reason: '仅参考生视频支持关闭音频'
-            },
-            apiField: 'audio'
-        },
-        {
-            id: 'ppioWan27AudioSetting',
-            type: 'dropdown',
-            order: 8,
-            valueType: 'string',
-            default: 'auto',
-            visible: {
-                condition: 'ppioWan27Mode === "video-edit"',
-                reason: '仅视频编辑支持声音设置'
-            },
-            options: [
-                { value: 'auto' },
-                { value: 'origin' }
-            ],
-            apiField: 'audio_setting'
-        },
-        {
-            id: 'ppioWan27PromptExtend',
-            type: 'switch',
-            order: 9,
-            valueType: 'boolean',
-            default: true,
-            visible: {
-                condition: 'ppioWan27Mode === "text-image-to-video"',
-                reason: '仅文/图生视频支持提示词改写'
-            },
-            apiField: 'prompt_extend'
-        }
-    ],
-    endpoints: {
-        default: '/async/wan2.7-t2v',
-        selector: (params) => {
-            const mode = typeof params.ppioWan27Mode === 'string'
-                ? params.ppioWan27Mode
-                : (typeof params.mode === 'string' ? params.mode : 'text-image-to-video');
-            const images = Array.isArray(params.uploadedFilePaths)
-                ? params.uploadedFilePaths.filter((item) => typeof item === 'string' && item.trim().length > 0)
-                : Array.isArray(params.images)
-                    ? params.images.filter((item) => typeof item === 'string' && item.trim().length > 0)
-                    : [];
-            const videos = Array.isArray(params.uploadedVideoFilePaths)
-                ? params.uploadedVideoFilePaths.filter((item) => typeof item === 'string' && item.trim().length > 0)
-                : Array.isArray(params.videos)
-                    ? params.videos.filter((item) => typeof item === 'string' && item.trim().length > 0)
-                    : [];
-            if (mode === 'video-edit') {
-                return '/async/wan2.7-videoedit';
-            }
-            if (mode === 'reference-to-video') {
-                return '/async/wan2.7-r2v';
-            }
-            if (mode === 'text-image-to-video' && (images.length > 0 || videos.length > 0)) {
-                return '/async/wan2.7-i2v';
-            }
-            return '/async/wan2.7-t2v';
-        }
-    },
-    request: {
-        builder: (params) => {
-            const filterSources = (value) => Array.isArray(value)
-                ? value.filter((item) => typeof item === 'string' && item.trim().length > 0)
-                : [];
-            const pickSources = (primary, fallback) => {
-                const preferred = filterSources(primary);
-                return preferred.length > 0 ? preferred : filterSources(fallback);
-            };
-            const images = pickSources(params.uploadedFilePaths, params.images);
-            const videos = pickSources(params.uploadedVideoFilePaths, params.videos);
-            const audios = pickSources(params.uploadedAudioFilePaths, params.audios);
-            const mode = typeof params.ppioWan27Mode === 'string'
-                ? params.ppioWan27Mode
-                : (typeof params.mode === 'string' ? params.mode : 'text-image-to-video');
-            const resolution = params.ppioWan27Resolution === '720P' ? '720P' : '1080P';
-            const aspectRatioCandidates = ['16:9', '9:16', '1:1', '4:3', '3:4'];
-            const rawAspectRatio = typeof params.ppioWan27AspectRatio === 'string'
-                ? params.ppioWan27AspectRatio
-                : (typeof params.aspect_ratio === 'string' ? params.aspect_ratio : '16:9');
-            const aspectRatio = aspectRatioCandidates.includes(rawAspectRatio) ? rawAspectRatio : '16:9';
-            const sizeMap = {
-                '16:9': { '720P': '1280*720', '1080P': '1920*1080' },
-                '9:16': { '720P': '720*1280', '1080P': '1080*1920' },
-                '1:1': { '720P': '960*960', '1080P': '1440*1440' },
-                '4:3': { '720P': '1088*832', '1080P': '1632*1248' },
-                '3:4': { '720P': '832*1088', '1080P': '1248*1632' }
-            };
-            const clampDuration = (value, min, max, fallback) => {
-                const parsed = Number(value);
-                if (!Number.isFinite(parsed)) {
-                    return fallback;
-                }
-                return Math.min(max, Math.max(min, Math.round(parsed)));
-            };
-            const readText = (value, maxLength) => {
-                return typeof value === 'string' ? value.slice(0, maxLength) : '';
-            };
-            const prompt = readText(params.prompt, mode === 'text-image-to-video' || mode === 'video-edit' ? 5000 : 1500);
-            const promptExtend = params.ppioWan27PromptExtend !== undefined
-                ? params.ppioWan27PromptExtend === true
-                : params.prompt_extend !== false;
-            const requestData = { watermark: false };
-            if (mode === 'video-edit') {
-                const duration = clampDuration(params.ppioWan27Duration ?? params.duration, 0, 10, 0);
-                requestData.prompt = prompt;
-                requestData.duration = duration;
-                requestData.video_url = videos[0] || '';
-                requestData.resolution = resolution;
-                requestData.audio_setting = params.ppioWan27AudioSetting === 'origin' ? 'origin' : 'auto';
-                requestData.prompt_extend = promptExtend;
-                const rawRatio = typeof params.ppioWan27EditRatio === 'string'
-                    ? params.ppioWan27EditRatio
-                    : (typeof params.ratio === 'string' ? params.ratio : 'auto');
-                if (aspectRatioCandidates.includes(rawRatio)) {
-                    requestData.ratio = rawRatio;
-                }
-                if (images[0]) {
-                    requestData.reference_image_url = images[0];
-                }
-                if (images[1]) {
-                    requestData.reference_image_url_2 = images[1];
-                }
-                if (images[2]) {
-                    requestData.reference_image_url_3 = images[2];
-                }
-                return requestData;
-            }
-            if (mode === 'reference-to-video') {
-                const duration = clampDuration(params.ppioWan27Duration ?? params.duration, 2, 10, 5);
-                requestData.prompt = prompt;
-                requestData.size = sizeMap[aspectRatio][resolution];
-                requestData.audio = params.ppioWan27Audio !== undefined ? params.ppioWan27Audio === true : params.audio !== false;
-                requestData.duration = duration;
-                requestData.shot_type = params.ppioWan27ShotType === 'multi' ? 'multi' : 'single';
-                requestData.media = [
-                    ...images.slice(0, 5).map((url, index) => ({
-                        url,
-                        type: index === 0 && params.ppioWan27ReferenceFirstFrame === true ? 'first_frame' : 'reference_image'
-                    })),
-                    ...videos.slice(0, 3).map((url) => ({ url, type: 'reference_video' }))
-                ].slice(0, 5);
-                return requestData;
-            }
-            if (mode === 'text-image-to-video') {
-                const duration = clampDuration(params.ppioWan27Duration ?? params.duration, 2, 15, 5);
-                requestData.prompt = prompt;
-                requestData.duration = duration;
-                requestData.prompt_extend = promptExtend;
-                if (videos[0]) {
-                    requestData.first_clip_url = videos[0];
-                    requestData.resolution = resolution;
-                }
-                else if (images[0]) {
-                    requestData.image_url = images[0];
-                    requestData.resolution = resolution;
-                }
-                if (images[1]) {
-                    requestData.last_frame_url = images[1];
-                }
-                if (audios[0]) {
-                    requestData[videos[0] || images[0] ? 'driving_audio_url' : 'audio_url'] = audios[0];
-                }
-                return requestData;
-            }
-            const duration = clampDuration(params.ppioWan27Duration ?? params.duration, 2, 15, 5);
-            requestData.prompt = prompt;
-            requestData.size = sizeMap[aspectRatio][resolution];
-            requestData.duration = duration;
-            requestData.prompt_extend = promptExtend;
-            if (audios[0]) {
-                requestData.audio_url = audios[0];
-            }
-            return requestData;
-        }
-    },
-    pricing: {
-        currency: '¥',
-        calculator: (params) => {
-            const mode = typeof params.ppioWan27Mode === 'string' ? params.ppioWan27Mode : 'text-image-to-video';
-            const resolution = params.ppioWan27Resolution === '720P' ? '720P' : '1080P';
-            const rawDuration = Number(params.ppioWan27Duration ?? params.duration);
-            const maxDuration = mode === 'reference-to-video' || mode === 'video-edit' ? 10 : 15;
-            const minDuration = mode === 'video-edit' ? 0 : 2;
-            const followsInputDuration = mode === 'video-edit' && (!Number.isFinite(rawDuration) || rawDuration <= 0);
-            const inputVideoDuration = followsInputDuration
-                ? resolveUploadedVideoDurationSeconds(params, 5)
-                : 0;
-            const duration = followsInputDuration
-                ? Math.min(maxDuration, Math.max(2, inputVideoDuration || 5))
-                : (Number.isFinite(rawDuration)
-                    ? Math.min(maxDuration, Math.max(minDuration, Math.round(rawDuration)))
-                    : 5);
-            const pricePerSecond = resolution === '720P' ? 0.6 : 1;
-            return pricePerSecond * duration;
-        },
-        description: '720P ¥0.6000/秒，1080P ¥1.0000/秒；按生成时长计费。'
-    }
-});
-export default wan27Model;

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

@@ -1,70 +0,0 @@
-# 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 | 否 |

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

@@ -1,76 +0,0 @@
-# TeleSpeechASR · 硅基流动
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-21 |
-| 模态 | ASR（同步文件转写） |
-| 供应商 | SiliconFlow / SiliconCloud |
-| 平台模型 ID | `TeleAI/TeleSpeechASR` |
-| 公开计费 | **未确认**：当前通用价格页未列该 ID |
-| 免费证据 | 官方“说点啥”用例将其列入该客户端的免费服务；不足以证明自有 Key 长期免费 |
-| 文档/价格 | 公开无需登录；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=TeleAI/TeleSpeechASR
-```
-
-`file` 必须不超过 1 小时、50 MB。官方转写端点明确把该 ID 列为 `model` enum，但未公开
-完整文件格式白名单，也未在端点层公开语言清单、热词、说话人、时间戳或其它模型特性。
-公开协议没有 WebSocket/SSE 实时接口。
-
-## 2. 响应契约
-
-```json
-{
-  "text": "<string>"
-}
-```
-
-响应头包含 `x-siliconcloud-trace-id`。在硅基流动当前公开端点中，两个 ASR model enum 共用同一个
-`text` 响应形状；不得凭模型名称猜测额外字段。
-
-## 3. 价格与免费不确定项
-
-- 2026-08-31 公开通用价格页的语音模型栏未找到 `TeleAI/TeleSpeechASR`，因此无法从价格页确认
-  自有 API Key 调用的单价或免费身份。
-- 官方“说点啥”用例把 TeleSpeechASR 与 SenseVoiceSmall 列为该客户端可选的“免费服务”，
-  但同页又将关闭免费服务后的“自己 API Key”作为另一种路径。这不能等价为所有 SiliconCloud
-  账号下长期 0 费用。
-- SDK 可先记录模型可调用，但在未取得控制台账单证据前，价格不应写 0；发布前需用目标账号复核。
-
-## 4. 错误与适配要点
-
-官方错误体可为 `{code,message,data}` JSON，也可为纯文本。常见状态为 400/401/403/429/
-500/503/504。SDK 的 `provider_http_error` 诊断文本保留 HTTP status、可用的
-`code/message/data`、文本 fallback 和脱敏后的 `x-siliconcloud-trace-id`；当前通用
-`AiRuntimeError` 不提供结构化供应商错误 metadata。
-
-Say-It/SDK 接入是简单 Bearer + multipart HTTP，但只能提交 `file/model`；其它 ASR 参数在官方端点
-未公开时应隐藏。中国大陆使用 `api.siliconflow.cn`；本轮未发起真实请求，可用性、限流与
-计费均需目标账号实测。
-
-## 5. 原始链接索引
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| ASR API、模型 ID、输入限制与响应 | https://docs.siliconflow.cn/docs/api/audio-transcriptions-post | 否 |
-| 当前通用价格页（该 ID 未列出） | https://siliconflow.cn/pricing | 否 |
-| 免费模型/实名/Rate Limits 规则 | https://docs.siliconflow.cn/cn/userguide/rate-limits/rate-limit-and-upgradation | 否 |
-| 客户端免费服务证据 | https://docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-BiBiKeyboard | 否 |
-| 错误处理 | https://docs.siliconflow.cn/cn/faqs/error-code | 否 |
-| API Key | https://cloud.siliconflow.cn/account/ak | **是** |
-
-## 2026-09-21 文件传输边界复核
-
-SDK 本地 multipart 默认上限为 50,000,000 字节，仍受官方 1 小时时长限制。与 SenseVoiceSmall 共享分块上传路径。

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

@@ -1,82 +0,0 @@
-# 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 | 否 |