@henjicc/ai-sdk 0.9.0 → 0.10.0

package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//345/277/253/351/200/237/351/200/202/351/205/215/344/276/233/345/272/224/345/225/206.md

@@ -1,65 +1,65 @@
-# 快速适配供应商
-
-> 目标：在写第一个模型文件前，先把供应商的稳定公共契约接好。后续模型适配只处理模型 ID、路由选择、参数和计价，不再重复写鉴权、上传、轮询与结果解析。
->
-> 最后更新：2026-08-26
-
-## 1. 先判定供应商是否已适配
-
-不要因为设置页能保存 API Key，就宣称供应商已适配。至少要核对下列公共契约：
-
-| 层级 | 必须确认 |
-|---|---|
-| 地址 | Base URL、区域/备用线路、相对路由拼接规则 |
-| 鉴权 | Header 格式、Key 类型、是否与区域/业务空间绑定 |
-| 提交 | 同步/异步、提交方法、任务 ID 路径、是否可安全重试 |
-| 查询 | 轮询端点、进行中/成功/失败状态、失败消息路径 |
-| 结果 | 图片/视频/音频 URL 路径、string/string[]、JSON 字符串嵌套、有效期 |
-| 上传 | 本地路径、Data URI、Base64、公网 URL、官方临时存储的转换规则 |
-| 价格 | 公开价格页、可编程价格 API、任务实际扣费字段的优先级 |
-| 余额 | 是否可用同一枚生成 API Key 查询；若需云账号 AK/SK，不混入生成适配 |
-
-只有“当前已接入模型的必需分支”全部可运行，才标记为“已适配”。供应商未来可能支持、但当前没有模型使用的协议，记录在文档中，不预先造运行时分支。
-
-## 2. 供应商基础文档模板
-
-每家供应商在本目录保留一份 `<供应商>.md`，固定按下列顺序编写：
-
-1. 摘要：`providerId`、类型、鉴权、同步/异步、文档与价格登录状态。
-2. Base URL：主线、区域、备用线路与 Key 绑定关系。
-3. 生成端点：只记公共路由；模型专属路由留在模型文档。
-4. 提交、轮询与回调：任务 ID、状态、结果、错误的精确字段路径。
-5. 文件上传：上传方法、限制、返回值、有效期与生成请求需要的额外 Header。
-6. 结果保存：是否需要二次换取下载链接，以及链接有效期。
-7. 计价和余额：官方价格页、API、任务实际扣费字段；余额只记同 Key 可安全查询的方案。
-8. 项目对照：已接入文件、已覆盖能力、明确欠账。
-9. 原始链接索引：每个链接标注提供的信息与登录要求。
-
-## 3. 代码接入顺序
-
-1. 在 `packages/ai-sdk/src/providers/<provider>.ts` 实现提交、轮询和结果解析。
-2. 在 `providers/index.ts` 注册生成与续轮询分发。
-3. 如需官方上传，只在 `upload-providers.ts` 实现协议，由 `upload.ts` 统一选择；禁止模型或 UI 自己上传。
-4. 在 `keystore.ts`、`src/core/config/providers.ts`、`settingsStore.ts` 补齐 Key 与供应商元信息。
-5. 先用一个最小模型验证完整链路，再批量增加模型定义。
-
-供应商代码不得引用 UI，模型定义不得自行发起 `fetch()`。
-
-## 4. 最小验收
-
-- 提交测试：断言 URL、方法、鉴权和请求体。
-- 轮询测试：覆盖进行中、成功、明确失败和查询暂时失败。
-- 结果测试：覆盖单 URL、URL 数组和嵌套 JSON 字符串。
-- 上传测试：覆盖成功、缺少 URL、鉴权失败和超限。
-- 收尾：按 [testing.md](../../../../../docs/rules/testing.md) 选择精确测试与对应 TypeScript 工程，不默认跑全量。
-
-## 5. 当前供应商速查
-
-| 供应商 | 基础文档 | 当前生成运行时 |
-|---|---|---|
-| APIMart | [APIMart.md](APIMart.md) | 已接入异步提交、轮询、图片上传、余额与大陆备用线路受控切换 |
-| KIE | [KIE.md](KIE.md) | 已接入统一 Market 任务、轮询、上传与余额 |
-| Fal | [Fal.md](Fal.md) | 已接入直连/队列、轮询与结果解析 |
-| 百炼 | [百炼.md](百炼.md) | 已接入当前同步图片模型；区域、临时上传和异步契约见文档 |
-| 火山引擎 | [火山引擎.md](火山引擎.md) | 已接入当前同步图片模型；Files API 不视为生成通用上传 |
-| Grsai | [Grsai.md](Grsai.md) | 已接入统一生成接口、轮询、双线路探测；余额查询未接入（鉴权方式未确认，见文档第 8 节第 4 项） |
+# 快速适配供应商
+
+> 目标：在写第一个模型文件前，先把供应商的稳定公共契约接好。后续模型适配只处理模型 ID、路由选择、参数和计价，不再重复写鉴权、上传、轮询与结果解析。
+>
+> 最后更新：2026-08-26
+
+## 1. 先判定供应商是否已适配
+
+不要因为设置页能保存 API Key，就宣称供应商已适配。至少要核对下列公共契约：
+
+| 层级 | 必须确认 |
+|---|---|
+| 地址 | Base URL、区域/备用线路、相对路由拼接规则 |
+| 鉴权 | Header 格式、Key 类型、是否与区域/业务空间绑定 |
+| 提交 | 同步/异步、提交方法、任务 ID 路径、是否可安全重试 |
+| 查询 | 轮询端点、进行中/成功/失败状态、失败消息路径 |
+| 结果 | 图片/视频/音频 URL 路径、string/string[]、JSON 字符串嵌套、有效期 |
+| 上传 | 本地路径、Data URI、Base64、公网 URL、官方临时存储的转换规则 |
+| 价格 | 公开价格页、可编程价格 API、任务实际扣费字段的优先级 |
+| 余额 | 是否可用同一枚生成 API Key 查询；若需云账号 AK/SK，不混入生成适配 |
+
+只有“当前已接入模型的必需分支”全部可运行，才标记为“已适配”。供应商未来可能支持、但当前没有模型使用的协议，记录在文档中，不预先造运行时分支。
+
+## 2. 供应商基础文档模板
+
+每家供应商在本目录保留一份 `<供应商>.md`，固定按下列顺序编写：
+
+1. 摘要：`providerId`、类型、鉴权、同步/异步、文档与价格登录状态。
+2. Base URL：主线、区域、备用线路与 Key 绑定关系。
+3. 生成端点：只记公共路由；模型专属路由留在模型文档。
+4. 提交、轮询与回调：任务 ID、状态、结果、错误的精确字段路径。
+5. 文件上传：上传方法、限制、返回值、有效期与生成请求需要的额外 Header。
+6. 结果保存：是否需要二次换取下载链接，以及链接有效期。
+7. 计价和余额：官方价格页、API、任务实际扣费字段；余额只记同 Key 可安全查询的方案。
+8. 项目对照：已接入文件、已覆盖能力、明确欠账。
+9. 原始链接索引：每个链接标注提供的信息与登录要求。
+
+## 3. 代码接入顺序
+
+1. 在 `packages/ai-sdk/src/providers/<provider>.ts` 实现提交、轮询和结果解析。
+2. 在 `providers/index.ts` 注册生成与续轮询分发。
+3. 如需官方上传，只在 `upload-providers.ts` 实现协议，由 `upload.ts` 统一选择；禁止模型或 UI 自己上传。
+4. 在 `keystore.ts`、`src/core/config/providers.ts`、`settingsStore.ts` 补齐 Key 与供应商元信息。
+5. 先用一个最小模型验证完整链路，再批量增加模型定义。
+
+供应商代码不得引用 UI，模型定义不得自行发起 `fetch()`。
+
+## 4. 最小验收
+
+- 提交测试：断言 URL、方法、鉴权和请求体。
+- 轮询测试：覆盖进行中、成功、明确失败和查询暂时失败。
+- 结果测试：覆盖单 URL、URL 数组和嵌套 JSON 字符串。
+- 上传测试：覆盖成功、缺少 URL、鉴权失败和超限。
+- 收尾：按 [testing.md](../../../../../docs/rules/testing.md) 选择精确测试与对应 TypeScript 工程，不默认跑全量。
+
+## 5. 当前供应商速查
+
+| 供应商 | 基础文档 | 当前生成运行时 |
+|---|---|---|
+| APIMart | [APIMart.md](APIMart.md) | 已接入异步提交、轮询、图片上传、余额与大陆备用线路受控切换 |
+| KIE | [KIE.md](KIE.md) | 已接入统一 Market 任务、轮询、上传与余额 |
+| Fal | [Fal.md](Fal.md) | 已接入直连/队列、轮询与结果解析 |
+| 百炼 | [百炼.md](百炼.md) | 已接入当前同步图片模型；区域、临时上传和异步契约见文档 |
+| 火山引擎 | [火山引擎.md](火山引擎.md) | 已接入当前同步图片模型；Files API 不视为生成通用上传 |
+| Grsai | [Grsai.md](Grsai.md) | 已接入统一生成接口、轮询、双线路探测；余额查询未接入（鉴权方式未确认，见文档第 8 节第 4 项） |

package/docs/model-adaptation//344/276/233/345/272/224/345/225/206//346/264/276/346/254/247/344/272/221.md

@@ -1,147 +1,170 @@
-# 派欧云 PPIO · 供应商基础文档
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-30 |
-| 供应商类型 | 聚合平台（自建推理集群） |
-| 覆盖模态 | 图片、视频、音频 |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-| 结算币种 | 人民币 ¥ |
-
-## 1. 接入协议
-
-- **Base URL**：`https://api.ppio.com/v3`
-- **鉴权**：`Authorization: Bearer <API_KEY>`
-- **提交**：`POST /v3/async/<model-route>`，返回 `{ "task_id": "..." }`
-- **查询**：`GET /v3/async/task-result?task_id=<id>`
-- **状态字段**：`/task/status`，枚举 `TASK_STATUS_QUEUED` / `TASK_STATUS_PROCESSING` / `TASK_STATUS_SUCCEED` / `TASK_STATUS_FAILED`
-- **结果字段**：`images[].image_url` / `videos[].video_url` / `audios[].audio_url`
-- **结果 URL 有效期**：默认 **3600 秒**，必须及时下载持久化
-
-部分音频接口同时提供同步版本（`POST /v3/<route>`，无 `async` 段），直接返回结果不需轮询；本项目统一走异步路由。
-
-### 域名（已切换）
-
-官网与全部文档示例现在使用 `https://api.ppio.com/v3`，`api.ppinfra.com` 在官网已无任何引用。
-
-**已实测**：两个域名对同一路由的响应完全一致（带无效 Key 请求 `/v3/async/kling-v3.0-std-t2v`，两者都返回 `{"code":403,"reason":"INVALID_API_KEY"}`），即旧域名仍在兼容且路由解析正常。代码已切到官方现行域名 `api.ppio.com`。
-
-## 2. 文件上传（重要限制）
-
-**PPIO 没有提供官方文件上传服务。** 本项目的处理方式定义在 `electron/main/services/ai-runtime/ppio-media.ts`，按字段名和路由决定媒体如何进入请求体：
-
-| 模式 | 触发条件 | 行为 |
-|---|---|---|
-| `raw-base64` | 字段名以 `_base64` / `_base64s` 结尾 | 裸 base64 字符串 |
-| `public-url` | 字段名以 `_url` / `_urls` 结尾、**任何视频素材**、`reference_voice` 字段，或命中特定路由白名单 | **必须是公网 HTTP(S) URL** |
-| `data-uri` | 其余情况（默认） | `data:<mime>;base64,<data>` 内联 |
-
-`public-url` 模式下，本项目**借用 KIE 的上传服务**换取公网 URL（`upload.ts` → `uploadForPublicUrl` → `uploadToKie`）。因此：
-
-> **用户如果只配置了 PPIO 的 API Key，没有配置 KIE Key，所有需要公网 URL 的 PPIO 模型都会直接失败**，错误提示为「当前 PPIO 模型字段要求公网 HTTP/HTTPS 媒体 URL。请直接传入公网 URL，或配置 KIE API Key」。
-
-这与项目规则「必须调用当前生成供应商自己的官方文件上传服务」存在张力，属于**已知的、供应商能力缺失导致的例外**，不是实现疏漏。新增 PPIO 模型时若涉及视频或 `_url` 字段，需要在产品侧明确这个前置依赖。
-
-## 3. 实名认证前置条件
-
-部分模型要求**个人或企业实名认证**后才能调用，未认证会直接报错：
-
-- Wan 2.5 Preview（全部路由）
-- MiniMax 声音克隆 `/v3/minimax-voice-cloning`
-
-这类限制在模型文档页以 Warning 形式标注，不体现在 API 错误码文档里。
-
-## 4. 在售模型清单（2026-08-26）
-
-PPIO 的媒体模型规模比其他聚合平台小得多，且**图像侧几乎空白**。
-
-### 图片（仅 2 条路由）
-
-| 模型 | 路由 | 价格 |
-|---|---|---|
-| Qwen-Image 文生图 | `/v3/async/qwen-image-txt2img` | ¥0.145/张 |
-| Qwen-Image 图像编辑 | `/v3/async/qwen-image-edit` | ¥0.145/张 |
-
-初代 20B Qwen-Image，**不是** Qwen Image 3.0。
-
-### 视频
-
-在售：Kling 3.0（7 条路由）、Kling 2.5 Turbo Pro、Wan 2.5 Preview、Wan 2.6、Wan 2.7、MiniMax Hailuo 2.3（含 Fast）、PixVerse V4.5。各自价格见对应模型文档。
-
-### 音频
-
-| 模型 | 路由 | 价格 |
-|---|---|---|
-| MiniMax Speech 2.8 HD | `/v3/[async/]minimax-speech-2.8-hd` | ¥3.5 / 万字符 |
-| MiniMax Speech 2.8 Turbo | `/v3/[async/]minimax-speech-2.8-turbo` | ¥2.0 / 万字符 |
-| MiniMax speech-2.6-hd | 路由未公开 | ¥3.5 / 万字符 |
-| MiniMax speech-2.6-turbo | 路由未公开 | ¥2.0 / 万字符 |
-| MiniMax 声音克隆 | `/v3/minimax-voice-cloning` | ¥9.9 / 音色 |
-| MiniMax 声音设计 | `/v3/minimax-voice-design` | ¥9.9 / 音色 |
-| MiniMax Music | `/v3/minimax-music` | music-2.5/2.5+ ¥1.0/首；music-2.0 ¥0.25/首 |
-| MiniMax Lyrics | `/v3/minimax-music-lyrics` | ¥0.05 / 首 |
-| Fish Audio TTS | 路由未公开 | ¥105 / 百万字符（≈¥1.05/万字符） |
-| Fish Audio Voice Clone | 路由未公开 | ¥0.7 / 音色 |
-
-**speech-2.6 系列与 Fish Audio 两条在定价页有价、说明仍在售，但文档站已不提供 API 参考页，路由无法确认。** PPIO 对所有未知路径统一返回 400，无法靠探测区分路由是否存在。要接入需要实测或联系 PPIO。
-
-MiniMax Speech 的公开商品注册表使用 `(单价 × 字符数 + 999999) / 1000000` 结算表达式，代表每次请求的字符费都**向上取整到人民币分**。声音克隆的试听是一次独立 TTS 计费，同样先向上取整到分，再叠加 ¥9.9 音色费。
-
-> Fish Audio 的 TTS 比 MiniMax Turbo 便宜约一半，声音克隆比 MiniMax 便宜 14 倍。若后续要做成本优化，这是值得优先确认路由的方向。
-
-### 主清单模型的覆盖情况
-
-项目「常用优秀模型清单」共 18 个，**PPIO 只提供其中 1 个**：
-
-| 清单模型 | PPIO |
-|---|---|
-| Kling 3.0 | ✅ 提供，见 [Kling-3.0_派欧云.md](../Kling-3.0/Kling-3.0_派欧云.md) |
-| 其余 17 个 | ❌ 全部没有 |
-
-**Seedream 与 Seedance 曾经上线过后又下架。** `/v3/video/create` 统一视频接口的配置里至今残留 `seedance_v1_pro_t2v`、`seedance_v1_lite_i2v`、`seedance_v1.5_pro_t2v/i2v` 等条目，但它们**不在定价页**，同批残留的还有 `kling2.1_*`、`wan2.2_*`、`minimax_hailuo_02`——这批都是已下架的旧条目。
-
-> **判定规则：以定价页为准，不要以 `/v3/video/create` 配置为准。** 对照证据：`kling2.5_turbo_pro_*` 同样只存在于统一配置、没有独立文档页，但定价页有价——说明定价页确实覆盖统一接口模型，因此 Seedance 在定价页的缺席是真缺席。
-
-## 5. 已适配模型文档索引
-
-| 模型 | 文档 | 是否在主清单 |
-|---|---|---|
-| Kling 3.0 | [Kling-3.0_派欧云.md](../Kling-3.0/Kling-3.0_派欧云.md) | ✅ 是 |
-| MiniMax Hailuo 2.3 | [Hailuo-2.3_派欧云.md](../Hailuo-2.3/Hailuo-2.3_派欧云.md) | 否 |
-| Wan 2.5 Preview | [Wan-2.5-Preview_派欧云.md](../Wan-2.5-Preview/Wan-2.5-Preview_派欧云.md) | 否 |
-| Wan 2.6 | [Wan-2.6_派欧云.md](../Wan-2.6/Wan-2.6_派欧云.md) | 否 |
-| Wan 2.7 | [Wan-2.7_派欧云.md](../Wan-2.7/Wan-2.7_派欧云.md) | 否 |
-| MiniMax Speech | [MiniMax-Speech_派欧云.md](../MiniMax-Speech/MiniMax-Speech_派欧云.md) | 否 |
-
-## 6. 适配要点
-
-- **请求体结构在 Wan 家族内部就不统一**：Wan 2.5 / 2.6 是 `{input: {...}, parameters: {...}}` 嵌套结构，Wan 2.7 是**扁平结构**。同家族不同版本不能共用 builder。
-- **同一模型的 t2v 与 i2v 分辨率字段名不同**：t2v 用 `size`（必须填 `1920*1080` 这类具体像素，不接受档位名或比例），i2v 用 `resolution`（枚举 `480P`/`720P`/`1080P`）。Wan 2.5、2.6、2.7 都是这个规律，极易踩坑。
-- **计价维度差异大**：Wan 2.5 / 2.6 按**视频条数**计费（分辨率 × 时长查表），Wan 2.7 与 Kling 3.0 按**秒**计费。同供应商内不能套用同一套计价模板。
-- **音频开关会改变单价档位**：Kling 3.0 的 `sound` 字段为 `true` 时单价上浮 50%；Wan 2.7 r2v 的 `audio` 字段同样影响费用。计价函数必须读这个字段。
-- 项目默认隐藏的参数（`seed`、负面提示词）：PPIO 多数模型都提供 `seed` 与 `negative_prompt` 字段，按项目约定**不显示、不请求**。
-- `output_format` 按项目约定不显示且不请求。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| 文档全量索引（llms.txt） | https://ppio.com/docs/llms.txt | 否 |
-| 定价页（图像/视频/音频 tab） | https://ppio.com/pricing | 否 |
-| 模型注册表 API（定价页自身调用） | https://api-server.ppio.com/v1/product/multimodal-model/list?returnSchema=true | 否 |
-| 商品批量价格 API（POST） | https://api-server.ppio.com/v1/product/batch-price | 否 |
-| 统一视频接口配置（23 个 model 取值 + JSON Schema） | https://api.ppio.com/v3/admin/video-unify-api/config | 否 |
-| LLM 更新日志（含历史上下架记录） | https://ppio.com/docs/announcement/changelog-llm.md | 否 |
-| API 鉴权方式 | https://ppio.com/docs/api/authentication | 否 |
-| API 错误码 | https://ppio.com/docs/api/error-codes | 否 |
-| API Key 管理 | https://ppio.com/settings/key-management | **是** |
-# 2026-09-11：文本检索能力
-
-公开来源：https://ppio.com/model/embedding/baai/bge-m3 、https://ppio.com/model/reranker/baai/bge-reranker-v2-m3 、https://ppio.com/docs/models/reference-llm-create-rerank 、https://ppio.com/docs/announcement/announcement 。
-
-- Bearer JSON POST，根地址 `https://api.ppio.com/openai/v1`；Embedding `/embeddings`，Rerank `/rerank`。注意与旧文档 `/v3/openai` 不混用。
-- `baai/bge-m3`：input 字符串或数组，encoding_format=float；8192 token上下文，返回 data[].embedding/index。输入0.07元/百万 token，输出0。
-- `baai/bge-reranker-v2-m3`：model/query/documents/top_n；返回 results[].index/relevance_score、可选 document.text、usage.prompt_tokens/completion_tokens/total_tokens。模型页显示输入/输出均0.07元/百万 token。未公布最大文档数量，不猜限制。
-- `qwen/qwen3-reranker-8b` 已在2026-01-08下线公告中列出，不因旧上架文章仍可搜索就重新加入。
-- 同步成功必须有合法结果；错误响应、缺失/重复/越界索引、非有限数值拒绝。取消沿用 AbortSignal，不自动截断或重试。SDK 返回对应输入文本，不依赖供应商是否回传原文。
+# 派欧云 PPIO · 供应商基础文档
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 供应商类型 | 聚合平台（自建推理集群） |
+| 覆盖模态 | 图片、视频、音频 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+| 结算币种 | 人民币 ¥ |
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.ppio.com/v3`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /v3/async/<model-route>`，返回 `{ "task_id": "..." }`
+- **查询**：`GET /v3/async/task-result?task_id=<id>`
+- **状态字段**：`/task/status`，枚举 `TASK_STATUS_QUEUED` / `TASK_STATUS_PROCESSING` / `TASK_STATUS_SUCCEED` / `TASK_STATUS_FAILED`
+- **结果字段**：`images[].image_url` / `videos[].video_url` / `audios[].audio_url`
+- **结果 URL 有效期**：默认 **3600 秒**，必须及时下载持久化
+
+部分音频接口同时提供同步版本（`POST /v3/<route>`，无 `async` 段），直接返回结果不需轮询；本项目统一走异步路由。
+
+### 域名（已切换）
+
+官网与全部文档示例现在使用 `https://api.ppio.com/v3`，`api.ppinfra.com` 在官网已无任何引用。
+
+**已实测**：两个域名对同一路由的响应完全一致（带无效 Key 请求 `/v3/async/kling-v3.0-std-t2v`，两者都返回 `{"code":403,"reason":"INVALID_API_KEY"}`），即旧域名仍在兼容且路由解析正常。代码已切到官方现行域名 `api.ppio.com`。
+
+## 2. 文件上传（重要限制）
+
+**PPIO 没有提供官方文件上传服务。** 本项目的处理方式定义在 `electron/main/services/ai-runtime/ppio-media.ts`，按字段名和路由决定媒体如何进入请求体：
+
+| 模式 | 触发条件 | 行为 |
+|---|---|---|
+| `raw-base64` | 字段名以 `_base64` / `_base64s` 结尾 | 裸 base64 字符串 |
+| `public-url` | 字段名以 `_url` / `_urls` 结尾、**任何视频素材**、`reference_voice` 字段，或命中特定路由白名单 | **必须是公网 HTTP(S) URL** |
+| `data-uri` | 其余情况（默认） | `data:<mime>;base64,<data>` 内联 |
+
+`public-url` 模式下，本项目**借用 KIE 的上传服务**换取公网 URL（`upload.ts` → `uploadForPublicUrl` → `uploadToKie`）。因此：
+
+> **用户如果只配置了 PPIO 的 API Key，没有配置 KIE Key，所有需要公网 URL 的 PPIO 模型都会直接失败**，错误提示为「当前 PPIO 模型字段要求公网 HTTP/HTTPS 媒体 URL。请直接传入公网 URL，或配置 KIE API Key」。
+
+这与项目规则「必须调用当前生成供应商自己的官方文件上传服务」存在张力，属于**已知的、供应商能力缺失导致的例外**，不是实现疏漏。新增 PPIO 模型时若涉及视频或 `_url` 字段，需要在产品侧明确这个前置依赖。
+
+## 3. 实名认证前置条件
+
+部分模型要求**个人或企业实名认证**后才能调用，未认证会直接报错：
+
+- Wan 2.5 Preview（全部路由）
+- MiniMax 声音克隆 `/v3/minimax-voice-cloning`
+
+这类限制在模型文档页以 Warning 形式标注，不体现在 API 错误码文档里。
+
+## 3.5 2026-11-07 起只保留大语言模型
+
+用户决定派欧云只用作大语言模型供应商：Kling 3.0 与 MiniMax Speech 两个生成模型已标记 `meta.deprecated`，用户界面不再列出，代码与本页资料保留。下面第 4 节是当时的媒体模型调研记录，不再代表痕迹AI 的接入范围。
+
+2026-11-07 用账号调用 `GET /openai/v1/models` 核对的大语言模型（节选与预设相关的条目）：`deepseek/deepseek-v4-pro`、`deepseek/deepseek-v4.1-flash`、`moonshotai/kimi-k3.1-pro`（另有 `-highspeed`）、`moonshotai/kimi-k3`、`zai-org/glm-5.3`、`zai-org/glm-5.2`、`xiaomimimo/mimo-v2.6-pro`、`xiaomimimo/mimo-v2.6-flash`、`minimax/minimax-m3.1-flash`、`qwen/qwen3.8-max`。`xiaomimimo/mimo-v2.5-pro` 已不在列表中；`moonshotai/kimi-k2.6`、`kimi-k2.7-code` 仍在列，但 Kimi 将于 2026 年底下线全部 K2 系列，已标记过时。
+
+## 4. 在售模型清单（2026-08-26）
+
+PPIO 的媒体模型规模比其他聚合平台小得多，且**图像侧几乎空白**。
+
+### 图片（仅 2 条路由）
+
+| 模型 | 路由 | 价格 |
+|---|---|---|
+| Qwen-Image 文生图 | `/v3/async/qwen-image-txt2img` | ¥0.145/张 |
+| Qwen-Image 图像编辑 | `/v3/async/qwen-image-edit` | ¥0.145/张 |
+
+初代 20B Qwen-Image，**不是** Qwen Image 3.0。
+
+### 视频
+
+在售：Kling 3.0（7 条路由）、Kling 2.5 Turbo Pro、Wan 2.5 Preview、Wan 2.6、Wan 2.7、MiniMax Hailuo 2.3（含 Fast）、PixVerse V4.5。各自价格见对应模型文档。
+
+### 音频
+
+| 模型 | 路由 | 价格 |
+|---|---|---|
+| MiniMax Speech 2.8 HD | `/v3/[async/]minimax-speech-2.8-hd` | ¥3.5 / 万字符 |
+| MiniMax Speech 2.8 Turbo | `/v3/[async/]minimax-speech-2.8-turbo` | ¥2.0 / 万字符 |
+| MiniMax speech-2.6-hd | 路由未公开 | ¥3.5 / 万字符 |
+| MiniMax speech-2.6-turbo | 路由未公开 | ¥2.0 / 万字符 |
+| MiniMax 声音克隆 | `/v3/minimax-voice-cloning` | ¥9.9 / 音色 |
+| MiniMax 声音设计 | `/v3/minimax-voice-design` | ¥9.9 / 音色 |
+| MiniMax Music | `/v3/minimax-music` | music-2.5/2.5+ ¥1.0/首；music-2.0 ¥0.25/首 |
+| MiniMax Lyrics | `/v3/minimax-music-lyrics` | ¥0.05 / 首 |
+| Fish Audio TTS | 路由未公开 | ¥105 / 百万字符（≈¥1.05/万字符） |
+| Fish Audio Voice Clone | 路由未公开 | ¥0.7 / 音色 |
+
+**speech-2.6 系列与 Fish Audio 两条在定价页有价、说明仍在售，但文档站已不提供 API 参考页，路由无法确认。** PPIO 对所有未知路径统一返回 400，无法靠探测区分路由是否存在。要接入需要实测或联系 PPIO。
+
+MiniMax Speech 的公开商品注册表使用 `(单价 × 字符数 + 999999) / 1000000` 结算表达式，代表每次请求的字符费都**向上取整到人民币分**。声音克隆的试听是一次独立 TTS 计费，同样先向上取整到分，再叠加 ¥9.9 音色费。
+
+> Fish Audio 的 TTS 比 MiniMax Turbo 便宜约一半，声音克隆比 MiniMax 便宜 14 倍。若后续要做成本优化，这是值得优先确认路由的方向。
+
+### 主清单模型的覆盖情况
+
+项目「常用优秀模型清单」共 18 个，**PPIO 只提供其中 1 个**：
+
+| 清单模型 | PPIO |
+|---|---|
+| Kling 3.0 | ✅ 提供，见 [Kling-3.0_派欧云.md](../Kling-3.0/Kling-3.0_派欧云.md) |
+| 其余 17 个 | ❌ 全部没有 |
+
+**Seedream 与 Seedance 曾经上线过后又下架。** `/v3/video/create` 统一视频接口的配置里至今残留 `seedance_v1_pro_t2v`、`seedance_v1_lite_i2v`、`seedance_v1.5_pro_t2v/i2v` 等条目，但它们**不在定价页**，同批残留的还有 `kling2.1_*`、`wan2.2_*`、`minimax_hailuo_02`——这批都是已下架的旧条目。
+
+> **判定规则：以定价页为准，不要以 `/v3/video/create` 配置为准。** 对照证据：`kling2.5_turbo_pro_*` 同样只存在于统一配置、没有独立文档页，但定价页有价——说明定价页确实覆盖统一接口模型，因此 Seedance 在定价页的缺席是真缺席。
+
+## 5. 已适配模型文档索引
+
+| 模型 | 文档 | 是否在主清单 |
+|---|---|---|
+| Kling 3.0 | [Kling-3.0_派欧云.md](../Kling-3.0/Kling-3.0_派欧云.md) | ✅ 是 |
+| MiniMax Speech | [MiniMax-Speech_派欧云.md](../MiniMax-Speech/MiniMax-Speech_派欧云.md) | 否 |
+
+## 6. 适配要点
+
+- **请求体结构在 Wan 家族内部就不统一**：Wan 2.5 / 2.6 是 `{input: {...}, parameters: {...}}` 嵌套结构，Wan 2.7 是**扁平结构**。同家族不同版本不能共用 builder。
+- **同一模型的 t2v 与 i2v 分辨率字段名不同**：t2v 用 `size`（必须填 `1920*1080` 这类具体像素，不接受档位名或比例），i2v 用 `resolution`（枚举 `480P`/`720P`/`1080P`）。Wan 2.5、2.6、2.7 都是这个规律，极易踩坑。
+- **计价维度差异大**：Wan 2.5 / 2.6 按**视频条数**计费（分辨率 × 时长查表），Wan 2.7 与 Kling 3.0 按**秒**计费。同供应商内不能套用同一套计价模板。
+- **音频开关会改变单价档位**：Kling 3.0 的 `sound` 字段为 `true` 时单价上浮 50%；Wan 2.7 r2v 的 `audio` 字段同样影响费用。计价函数必须读这个字段。
+- 项目默认隐藏的参数（`seed`、负面提示词）：PPIO 多数模型都提供 `seed` 与 `negative_prompt` 字段，按项目约定**不显示、不请求**。
+- `output_format` 按项目约定不显示且不请求。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文档全量索引（llms.txt） | https://ppio.com/docs/llms.txt | 否 |
+| 定价页（图像/视频/音频 tab） | https://ppio.com/pricing | 否 |
+| 模型注册表 API（定价页自身调用） | https://api-server.ppio.com/v1/product/multimodal-model/list?returnSchema=true | 否 |
+| 商品批量价格 API（POST） | https://api-server.ppio.com/v1/product/batch-price | 否 |
+| 统一视频接口配置（23 个 model 取值 + JSON Schema） | https://api.ppio.com/v3/admin/video-unify-api/config | 否 |
+| LLM 更新日志（含历史上下架记录） | https://ppio.com/docs/announcement/changelog-llm.md | 否 |
+| API 鉴权方式 | https://ppio.com/docs/api/authentication | 否 |
+| API 错误码 | https://ppio.com/docs/api/error-codes | 否 |
+| API Key 管理 | https://ppio.com/settings/key-management | **是** |
+# 2026-09-11：文本检索能力
+
+公开来源：https://ppio.com/model/embedding/baai/bge-m3 、https://ppio.com/model/reranker/baai/bge-reranker-v2-m3 、https://ppio.com/docs/models/reference-llm-create-rerank 、https://ppio.com/docs/announcement/announcement 。
+
+- Bearer JSON POST，根地址 `https://api.ppio.com/openai/v1`；Embedding `/embeddings`，Rerank `/rerank`。注意与旧文档 `/v3/openai` 不混用。
+- `baai/bge-m3`：input 字符串或数组，encoding_format=float；8192 token上下文，返回 data[].embedding/index。输入0.07元/百万 token，输出0。
+- `baai/bge-reranker-v2-m3`：model/query/documents/top_n；返回 results[].index/relevance_score、可选 document.text、usage.prompt_tokens/completion_tokens/total_tokens。模型页显示输入/输出均0.07元/百万 token。未公布最大文档数量，不猜限制。
+- `qwen/qwen3-reranker-8b` 已在2026-01-08下线公告中列出，不因旧上架文章仍可搜索就重新加入。
+- 同步成功必须有合法结果；错误响应、缺失/重复/越界索引、非有限数值拒绝。取消沿用 AbortSignal，不自动截断或重试。SDK 返回对应输入文本，不依赖供应商是否回传原文。
+
+## 2026-10-12 默认模型
+
+旧 deepseek/deepseek-v4-flash 于 2026-10-10 停服，默认与推荐改用 deepseek/deepseek-v4.1-flash，不迁移用户已存配置。网关模型公开页确认 1M 上下文、函数工具、响应格式、采样参数；输入/输出/缓存读为 CNY 2/8/0.04 每百万 tokens。图片、Responses、并行工具、思考私有开关与输出上限未证实，能力按 false/null 保守登记，响应格式只登记 JSON。来源：[停服](https://ppio.com/docs/announcement/announcement.md)、[模型](https://ppio.com/llm/deepseek-deepseek-v4.1-flash)（公开无需登录）。
+
+## 2026-11-08 大语言模型价格
+
+模型详情页 `https://ppio.com/model/<模型 ID>` 与汇总页 https://ppio.com/pricing 数字一致，均无需登录（旧的 `ppio.com/llm/<slug>` 已跳转到无价格的列表页）。页面只显示“当前时段实际价格”，DeepSeek V4.1 Flash 的高峰价在详情页“查看其他时段刊例价”里：高峰为北京时间周一至周五 09:00–12:00、14:00–18:00，其余时段与周末全天为闲时。单位元/百万 tokens。
+
+| 模型 | 输入 | 输出 | 缓存读取 | 备注 |
+|---|---|---|---|---|
+| `deepseek/deepseek-v4-pro` | 9 | 27 | 3 | `deepseek-v4-pro-0813` 同价；缓存读取是页面原值（原厂与方舟为 0.3），2026-11-08 复核 |
+| `deepseek/deepseek-v4.1-flash` | 高峰 2 / 闲时 1 | 高峰 8 / 闲时 4 | 高峰 0.04 / 闲时 0.02 | /pricing 显示名为“DeepSeek V4.1 Flash 1017” |
+| `moonshotai/kimi-k3.1-pro` | 13 | 68 | 1.3 | 缓存写入 5 分钟 13、1 小时 26 |
+| `moonshotai/kimi-k3` | 20 | 100 | 2 | 缓存写入 5 分钟 20、1 小时 40 |
+| `zai-org/glm-5.3` | 8 | 28 | 2 | |
+| `xiaomimimo/mimo-v2.6-pro` | 3 | 6 | 0.025 | |
+| `minimax/minimax-m3.1-flash` | 1 | 4 | 0.1 | |
+| `moonshotai/kimi-k2.6` | 6.5 | 27 | 1.1 | 上下文 262.1K |
+
+计费说明页 https://ppio.com/docs/model/llm-billing 只说按 token 计费，没有给文字折算比例，也没说按底层模型的分词器计数。