@henjicc/ai-sdk 0.9.0 → 0.10.0

package/docs/model-adaptation/README.md

@@ -1,338 +1,379 @@
-# 模型适配清单（总索引）
-
-本目录是**痕迹AI 的模型适配唯一资料源**。Henji-AI 同时是 `@henjicc/ai-sdk` 的主开发仓库与首发验证宿主；官方调研、实现和完整验证先在这里闭环，发布后消费项目才精确锁版本接入。适配思路已从「挑一个供应商、把它的模型尽量做全」调整为：
-**先定一份常用且优秀的模型清单，再为清单里的每个模型逐一接入所有支持它的供应商。**
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-28 |
-| 模型数量 | 生成主清单 20（图片 11 / 视频 9）+ 主清单外存量 12 + SDK 跨项目能力模型 20（ASR 15 / 翻译 3 / LLM 2） |
-| 模型供应商文档数量 | 生成/存量 84 + SDK 跨项目能力 20（另有 Fal 工具 12） |
-| 覆盖供应商 | 火山引擎（官方生成/ASR）、百炼（官方）、硅基流动（官方 ASR）、智谱（官方 LLM）、Groq（官方 LLM/ASR）、APIMart、KIE、Fal、派欧云、魔搭、Grsai |
-
-另有 12 个按能力按需分发的 Fal 图像工具，不进入默认 124 模型兼容目录：
-
-- 消除：[Flux Pro Erase](Flux-Pro-Erase/Flux-Pro-Erase_Fal.md)、[Bria Eraser](Bria-Eraser/Bria-Eraser_Fal.md)、[Finegrain Eraser](Finegrain-Eraser/Finegrain-Eraser_Fal.md)。
-- 图片实用工具：[Image Apps v2 重打光](Image-Apps-v2-重打光/Image-Apps-v2-重打光_Fal.md)、[ControlLight](ControlLight/ControlLight_Fal.md)、[Image Apps v2 扩图](Image-Apps-v2-扩图/Image-Apps-v2-扩图_Fal.md)、[Image Apps v2 商品摄影](Image-Apps-v2-商品摄影/Image-Apps-v2-商品摄影_Fal.md)、[Image Apps v2 照片修复](Image-Apps-v2-照片修复/Image-Apps-v2-照片修复_Fal.md)、[Pixelcut 背景移除](Pixelcut-背景移除/Pixelcut-背景移除_Fal.md)。
-- 多角度：[Qwen Image Edit 2511 多角度](Qwen-Image-Edit-2511-多角度/Qwen-Image-Edit-2511-多角度_Fal.md)、[透视变换](透视变换/透视变换_Fal.md)、[FLUX 2 多角度](FLUX-2-多角度/FLUX-2-多角度_Fal.md)。
-
-工具均复用 Fal 队列、上传与结果解析；它们是独立的按需 SDK 入口，不是新的执行内核。Henji-AI 运行客户端显式装载三个 pack，但普通模型选择器为 124 个默认模型：六个图片实用工具通过图片能力菜单创建固定模型节点，三个多角度工具由专用多角度节点选择，消除工具保留给后续遮罩能力接入。真实质量、延迟和账单仍待获得付费授权后验证。
-
-## 2026-09-27 TTS 适配
-
-2026-09-28：[豆包语音 2.0](Seed-ICL-2.0/Seed-ICL-2.0_火山引擎.md) 提供语音合成 / 克隆声音两模式，内置官方 431 个系统音色，并按系统/克隆音色选择 TTS/ICL 资源。接入官方 V3 训练与查询、自动后付费音色编号、克隆提交费用二次确认、试听和首次合成费用确认；Seed-TTS / ICL 2.0 公开价格更新为 3 元/万字符。
-
-[TTS 多供应商适配契约](TTS-多供应商-2026-09.md)：新增 13 个文字转语音模型，覆盖 Fal、百炼、KIE、硅基流动与火山语音；派欧云 MiniMax Speech 2.8 继续使用已有接入。记录官方接口、价格、音色前提、流式响应和测试样本来源。
-
-2026-09-27 补充官方音色目录及账号查询接口：Qwen Audio 3.1、Seed-TTS 2.0 使用核对后的预置清单；百炼 MiniMax / Qwen / CosyVoice 与硅基流动 CosyVoice2 支持按账号查询可用音色。接口字段、适用模型和不可查询渠道的边界见上方契约。
-
-## 2026-09-24 已适配更新
-
-- [HappyHorse 1.1 · KIE](HappyHorse-1.1/HappyHorse-1.1_KIE.md)：文生、图生与多图参考。
-- [Seedream 5.0 Flash · 火山方舟](Seedream-5.0-Flash/Seedream-5.0-Flash_火山引擎.md)：生成、编辑与图层拆分。
-- [GLM Flash / FlashX](GLM-5.3-Flash/GLM-5.3-Flash_智谱.md)：新增 FlashX 与 JSON 契约。
-- [百炼 ASR](供应商/百炼.md)：新增 Qwen-Audio 3.1 三种语音识别协议预设。
-- [MiMo 2.6 与 Responses](../llm-adaptation/供应商/小米MiMo.md)、[Kimi 缓存价格](../llm-adaptation/供应商/Kimi.md)。
-
-## 一、目录结构约定
-
-### 文本 Embedding / Rerank（2026-09-11）
-
-SDK 使用独立 `capabilities/embedding/<provider>` 与 `capabilities/rerank/<provider>` 入口，显式注册到能力客户端和发现目录，不混入图片生成目录。
-
-| 供应商 | Embedding | Rerank | 协议资料 |
-|---|---|---|---|
-| 硅基流动 | Qwen3 8B/4B/0.6B、BGE-M3 | Qwen3 8B/4B/0.6B、BGE v2 M3 | [供应商资料](供应商/硅基流动.md) |
-| 百炼 | Qwen3.7、Qwen3.7 Flash、v4 | Qwen3.7、Qwen3、GTE v2 | [供应商资料](供应商/百炼.md) |
-| 派欧云 | BGE-M3 | BGE v2 M3 | [供应商资料](供应商/派欧云.md) |
-| 智谱 | embedding-3 | rerank | 见下方官方依据 |
-| 火山方舟 | Doubao Embedding Vision 251215（文本单条） | VikingDB 独立服务暂未适配 | [供应商资料](供应商/火山引擎.md) |
-
-智谱直接依据：[Embedding API](https://docs.bigmodel.cn/api-reference/模型-api/文本嵌入)、[Embedding-3 模型](https://docs.bigmodel.cn/cn/guide/models/embedding/embedding-3)、[Rerank API](https://docs.bigmodel.cn/api-reference/模型-api/文本重排序)、[公开价格](https://bigmodel.cn/pricing)。国内根地址 `https://open.bigmodel.cn`，Bearer。Embedding POST `/api/paas/v4/embeddings`，model=embedding-3，input 字符串数组，最多 64 条，dimensions=256/512/1024/2048；返回 data 数组的 index/embedding。字段表限制每条 3072 tokens，概述 8K 表述存在冲突，不用字符数猜 token 限制。Rerank POST `/api/paas/v4/rerank`，model=rerank，query/documents/top_n；最多 128 条，每条及 query 最多 4096 字符；返回 results 的 index/relevance_score。省略 top_n 返回全部；SDK 显式 topN 必须为正整数，超出候选数裁到候选数。文本从原输入索引回填。Embedding 公开价 0.5 元/百万 tokens，Rerank 搜索可见官方价格 0.8 元/百万 tokens，价格页运行时需要 JavaScript，实际账单以控制台为准。
-
-共同验证边界：非流式单次 HTTP；空结果、缺失/重复/越界索引、非数值向量/分数不当作成功。向量维度必须一致；显式要求维度必须匹配。HTTP 错误、JSON 错误、供应商 error/code、取消和超时均失败；不自动重试付费 POST，不记录原文或凭据。未做真实付费验证。
-
-其他现有供应商也进行了检索核对：[APIMart 官方 AnythingLLM 指南](https://docs.apimart.ai/cn/integrations/chat/anythingllm) 提及 text-embedding-3-small/large，但本轮未取到独立端点字段表与价格，保留待核验；[魔搭 API 推理介绍](https://modelscope.cn/docs/model-service/API-Inference/intro) 本次无法读取正文，模型仓库存在权重不等于托管 API 已开放。Groq、DeepSeek、Fal、KIE、Grsai 的公开入口搜索未获得足以适配这两类能力的完整契约，不据此断言平台不支持。
-
-```
-docs/model-adaptation/
-├── README.md                      # 本文件：总清单 + 索引
-├── 文档采集手册.md                  # 官方调研、事件契约、fixture 与 SDK 首发验证的唯一详细规范
-├── 供应商/                         # 先完成供应商公共协议，再做具体模型
-│   ├── 快速适配供应商.md             # 新供应商的统一核对与落地清单
-│   ├── APIMart.md
-│   ├── KIE.md
-│   ├── Fal.md
-│   ├── Groq.md
-│   ├── 硅基流动.md
-│   ├── 百炼.md
-│   ├── 火山引擎.md
-│   ├── 派欧云.md
-│   └── 魔搭.md
-├── <模型名>/                       # 一个模型一个文件夹
-│   └── <模型名>_<供应商名>.md       # 支持该模型的每个供应商一个文件
-```
-
-- **供应商名**使用项目内统一的显示名：
-  派欧云 / Fal / 魔搭 / KIE / APIMart / 百炼 / 火山引擎 / 硅基流动 / Grsai / Groq（Grsai/Groq 沿用官方品牌拼写）
-- 每个供应商文件都是**自包含**的：接入协议、能力清单、请求参数、响应结构、价格、适配要点、原始链接索引，看完这一份就能完成该供应商的适配
-- 每份文件都标注**信息来源链接**以及**该链接是否需要登录**
-
-### 供应商基础文档
-
-模型适配前先看 [快速适配供应商](供应商/快速适配供应商.md)，确认供应商公共层已经覆盖端点、鉴权、上传、任务查询、结果解析和计价。现有十家基础文档：
-
-- [APIMart](供应商/APIMart.md)：含中国大陆备用线路与图片上传协议
-- [KIE](供应商/KIE.md)：生成任务、文件上传、实际扣费与余额查询
-- [Fal](供应商/Fal.md)：同步 / 队列协议、Fal CDN、官方计价 API
-- [百炼](供应商/百炼.md)：地域端点、临时 OSS 上传与同步 / 异步边界
-- [火山引擎](供应商/火山引擎.md)：方舟图片，以及 SeedASR 2.0 实时/文件两套独立协议与计费
-- [硅基流动](供应商/硅基流动.md)：multipart 文件转写、免费模型与在线文档/历史公告冲突
-- [派欧云](供应商/派欧云.md)：异步任务协议、**无官方上传（借用 KIE）**、实名认证前置、在售清单极小
-- [魔搭](供应商/魔搭.md)：API-Inference 统一接口、**魔粒积分计费**、仅图片、可用性判定方法
-- [Grsai](供应商/Grsai.md)：聚合中转，**同一模型拆多个「渠道」**（`-cl`/`-vip`/`-vt`/`-lite` 等后缀，价差可达 10 倍以上）、无独立上传接口（图片直接 base64/URL 塞进请求体）、双线路连通性探测
-- [Groq](供应商/Groq.md)：OpenAI 兼容 LLM、Whisper 文件转写、动态模型发现、价格/免费层与错误边界
-- [智谱 GLM](../llm-adaptation/供应商/智谱GLM.md)：国内 BigModel / 国际 Z.AI 两个 endpoint profile、OpenAI 兼容 Chat 与供应商级思考约定；模型专属契约仍以本目录模型文件为准
-
-尚未适配的图片工具供应商候选统一记录在[图片工具候选供应商调研](供应商/候选供应商调研-图片工具.md)：当前优先级为 Segmind / WaveSpeedAI（P0）、PiAPI（P1）、Replicate（P2）、Novita AI（P3）；中国内地访问友好性均需真实网络验证，不能仅凭中文站或支付方式下结论。
-
-## 二、通用适配规则
-
-1. **默认绝对不显示的参数**：随机种子 `seed`、负面提示词。
-   即使供应商提供了这两个字段，也**不注册、不下发**。各文件的「适配要点」会逐一标出哪个供应商有这两个字段。
-2. **`output_format` 默认不显示且不请求**，保持供应商默认值。
-3. 价格以**供应商的定价页 / 模型 `llms.txt` / 任务返回的 `cost`** 为准；部分 API 文档正文中的价格已过期，出现不一致时文件内会同时列出两处并说明取舍。
-4. 各供应商同名参数的**默认值、取值集合、字段名经常不一致**（例如 `adaptive` vs `auto`、整数 `5` vs 字符串 `"5"`），必须按供应商分别声明 schema，不要共用常量。
-5. 价格依赖本地媒体像素、时长或文件指标时，由模型在 `pricing.mediaContext` 声明需求，宿主统一读取并注入 calculator；禁止在单个页面或画布节点复制媒体计价逻辑。指标未解析完成时不显示伪造的兜底总价。
-
-## 三、模型清单
-
-### 图片（11）
-
-| 模型 | 火山引擎 | 百炼 | APIMart | KIE | Fal | 派欧云 | 魔搭 | Grsai |
-|---|---|---|---|---|---|---|---|---|
-| [Seedream 5.0 Pro](Seedream-5.0-Pro/) | [✅ 官方](Seedream-5.0-Pro/Seedream-5.0-Pro_火山引擎.md) | — | [✅](Seedream-5.0-Pro/Seedream-5.0-Pro_APIMart.md) | [✅](Seedream-5.0-Pro/Seedream-5.0-Pro_KIE.md) | [✅](Seedream-5.0-Pro/Seedream-5.0-Pro_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
-| [Seedream 5.0 Lite](Seedream-5.0-Lite/) | [✅ 官方](Seedream-5.0-Lite/Seedream-5.0-Lite_火山引擎.md) | — | [✅](Seedream-5.0-Lite/Seedream-5.0-Lite_APIMart.md) | [✅](Seedream-5.0-Lite/Seedream-5.0-Lite_KIE.md) | [✅](Seedream-5.0-Lite/Seedream-5.0-Lite_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
-| [Qwen Image 3.0](Qwen-Image-3.0/) | — | [✅ 官方](Qwen-Image-3.0/Qwen-Image-3.0_百炼.md) | [✅](Qwen-Image-3.0/Qwen-Image-3.0_APIMart.md) | [✅](Qwen-Image-3.0/Qwen-Image-3.0_KIE.md) | [✅](Qwen-Image-3.0/Qwen-Image-3.0_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
-| [Z-Image Turbo](Z-Image-Turbo/) | — | [✅ 官方](Z-Image-Turbo/Z-Image-Turbo_百炼.md) | [✅](Z-Image-Turbo/Z-Image-Turbo_APIMart.md) | [✅](Z-Image-Turbo/Z-Image-Turbo_KIE.md) | [✅](Z-Image-Turbo/Z-Image-Turbo_Fal.md) | ❌ 无 | [✅](Z-Image-Turbo/Z-Image-Turbo_魔搭.md) | ❌ 无 |
-| [GPT-Image-2](GPT-Image-2/) | — | — | [✅](GPT-Image-2/GPT-Image-2_APIMart.md) | [✅](GPT-Image-2/GPT-Image-2_KIE.md) | [✅](GPT-Image-2/GPT-Image-2_Fal.md) | ❌ 无 | ❌ 无 | [✅](GPT-Image-2/GPT-Image-2_Grsai.md) |
-| [IC-Light v2](IC-Light-v2/) | — | — | ❌ 无 | ❌ 无 | [✅](IC-Light-v2/IC-Light-v2_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
-| [Nano Banana 2](Nano-Banana-2/) | — | — | [✅](Nano-Banana-2/Nano-Banana-2_APIMart.md) | [✅](Nano-Banana-2/Nano-Banana-2_KIE.md) | [✅](Nano-Banana-2/Nano-Banana-2_Fal.md) | ❌ 无 | ❌ 无 | [✅](Nano-Banana-2/Nano-Banana-2_Grsai.md) |
-| [Nano Banana 2 Lite](Nano-Banana-2-Lite/) | — | — | [✅](Nano-Banana-2-Lite/Nano-Banana-2-Lite_APIMart.md) | [✅](Nano-Banana-2-Lite/Nano-Banana-2-Lite_KIE.md) | ❌ 无（已探测确认，见 [Fal 文档说明](Nano-Banana-2/Nano-Banana-2_Fal.md)） | ❌ 无 | ❌ 无 | [✅](Nano-Banana-2-Lite/Nano-Banana-2-Lite_Grsai.md) |
-| [Nano Banana Pro](Nano-Banana-Pro/) | — | — | [✅](Nano-Banana-Pro/Nano-Banana-Pro_APIMart.md) | [✅](Nano-Banana-Pro/Nano-Banana-Pro_KIE.md) | [✅](Nano-Banana-Pro/Nano-Banana-Pro_Fal.md) | ❌ 无 | ❌ 无 | [✅](Nano-Banana-Pro/Nano-Banana-Pro_Grsai.md) |
-| [Midjourney](Midjourney/) | — | — | [✅](Midjourney/Midjourney_APIMart.md) | ❌ 无 | ❌ 无 | ❌ 无 | ❌ 无 | ❌ 无 |
-| [Grok Imagine 2.0](Grok-Imagine-2.0/) | — | — | [✅](Grok-Imagine-2.0/Grok-Imagine-2.0_APIMart.md) | [✅](Grok-Imagine-2.0/Grok-Imagine-2.0_KIE.md) | [✅](Grok-Imagine-2.0/Grok-Imagine-2.0_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
-
-**Nano Banana 2 Lite 是独立模型，不是 Nano Banana 2 的分辨率/渠道选项**：代码里两者 `canonicalModelId` 不同（`nano-banana-2` vs `nano-banana-2-lite`），`generationModelDescriptions.ts` 也各自维护一条独立描述，APIMart/KIE 均已用独立 `.model.ts` 文件实现，因此本表把它列为单独一行，不再挂在 Nano Banana 2 文档里。
-
-### 视频（9）
-
-| 模型 | APIMart | KIE | Fal | 派欧云 | 魔搭 |
-|---|---|---|---|---|---|
-| [Seedance 2.0](Seedance-2.0/) | [✅](Seedance-2.0/Seedance-2.0_APIMart.md) | [✅](Seedance-2.0/Seedance-2.0_KIE.md) | [✅](Seedance-2.0/Seedance-2.0_Fal.md) | ❌ 已下架 | ❌ 无 |
-| [Seedance 2.0 Fast](Seedance-2.0-Fast/) | [✅](Seedance-2.0-Fast/Seedance-2.0-Fast_APIMart.md) | [✅](Seedance-2.0-Fast/Seedance-2.0-Fast_KIE.md) | [✅](Seedance-2.0-Fast/Seedance-2.0-Fast_Fal.md) | ❌ 已下架 | ❌ 无 |
-| [Seedance 2.0 Mini](Seedance-2.0-Mini/) | [✅](Seedance-2.0-Mini/Seedance-2.0-Mini_APIMart.md) | [✅](Seedance-2.0-Mini/Seedance-2.0-Mini_KIE.md) | [✅](Seedance-2.0-Mini/Seedance-2.0-Mini_Fal.md) | ❌ 已下架 | ❌ 无 |
-| [Seedance 2.5](Seedance-2.5/) | [✅](Seedance-2.5/Seedance-2.5_APIMart.md) | [✅](Seedance-2.5/Seedance-2.5_KIE.md) | [✅](Seedance-2.5/Seedance-2.5_Fal.md) | ❌ 已下架 | ❌ 无 |
-| [MiniMax H3](MiniMax-H3/) | [✅](MiniMax-H3/MiniMax-H3_APIMart.md) | [✅](MiniMax-H3/MiniMax-H3_KIE.md) | [✅](MiniMax-H3/MiniMax-H3_Fal.md) | ❌ 无 | ❌ 无 |
-| [Kling 3.0](Kling-3.0/) | [✅](Kling-3.0/Kling-3.0_APIMart.md) | [✅](Kling-3.0/Kling-3.0_KIE.md) | [✅](Kling-3.0/Kling-3.0_Fal.md) | [✅](Kling-3.0/Kling-3.0_派欧云.md) | ❌ 无 |
-| [Kling 3.0 Turbo](Kling-3.0-Turbo/) | [✅](Kling-3.0-Turbo/Kling-3.0-Turbo_APIMart.md) | [✅](Kling-3.0-Turbo/Kling-3.0-Turbo_KIE.md) | [✅](Kling-3.0-Turbo/Kling-3.0-Turbo_Fal.md) | ❌ 无 | ❌ 无 |
-| [Kling 3.0 Omni](Kling-3.0-Omni/) | [✅](Kling-3.0-Omni/Kling-3.0-Omni_APIMart.md) | [✅](Kling-3.0-Omni/Kling-3.0-Omni_KIE.md) | [✅](Kling-3.0-Omni/Kling-3.0-Omni_Fal.md) | ❌ 无 | ❌ 无 |
-| [Gemini Omni Flash](Gemini-Omni-Flash/) | [✅](Gemini-Omni-Flash/Gemini-Omni-Flash_APIMart.md) | [✅](Gemini-Omni-Flash/Gemini-Omni-Flash_KIE.md) | [✅](Gemini-Omni-Flash/Gemini-Omni-Flash_Fal.md) | ❌ 无 | ❌ 无 |
-
-视频类模型在**火山引擎与百炼上未纳入本清单**：Seedance 系列的官方接口不在本次适配范围，Kling 官方接口按用户要求**仅作参考、暂不适配**（能力地图：https://www.klingai.com/document-api/guides/capability-map/video ）。
-
-Grsai 暂未在此表出现：其站内「Veo API」旧版文档给出了 `veo3.1-fast` 视频模型的端点，但该模型**未出现在 dashboard「模型列表」的定价清单中**，可用性与计价未确认，详见 [Grsai 基础文档 §8](供应商/Grsai.md)。
-
-### 主清单外存量模型（12）
-
-以下模型**不在主清单里**，但已在代码中适配并对用户开放，文档用于维护现有实现。部分模型已有多个供应商入口，未来是否纳入主清单待定。
-
-| 模型 | 模态 | 供应商 | 文档 |
-|---|---|---|---|
-| MiniMax Hailuo 2.3 | 视频 | 派欧云 / KIE / Fal | [派欧云](Hailuo-2.3/Hailuo-2.3_派欧云.md) / [KIE](Hailuo-2.3/Hailuo-2.3_KIE.md) / [Fal](Hailuo-2.3/Hailuo-2.3_Fal.md) |
-| MiniMax Hailuo 02 | 视频 | KIE / Fal | [KIE](Hailuo-02/Hailuo-02_KIE.md) / [Fal](Hailuo-02/Hailuo-02_Fal.md) |
-| Grok Imagine | 图片 | KIE | [KIE](Grok-Imagine/Grok-Imagine_KIE.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) |
-| Topaz 图片放大 | 图片 | Fal | [Topaz-图片放大_Fal.md](Topaz-图片放大/Topaz-图片放大_Fal.md) |
-| Topaz 透明图放大 | 图片 | Fal | [Topaz-透明图放大_Fal.md](Topaz-透明图放大/Topaz-透明图放大_Fal.md) |
-| SeedVR2 图片放大 | 图片 | Fal | [SeedVR2-图片放大_Fal.md](SeedVR2-图片放大/SeedVR2-图片放大_Fal.md) |
-| Bria 创意放大 | 图片 | Fal | [Bria-创意放大_Fal.md](Bria-创意放大/Bria-创意放大_Fal.md) |
-| Ideogram 图片放大 | 图片 | Fal | [Ideogram-图片放大_Fal.md](Ideogram-图片放大/Ideogram-图片放大_Fal.md) |
-
-魔搭侧另有 5 个已适配的开源图像模型（`Qwen/Qwen-Image`、`Qwen/Qwen-Image-Edit-2509`、`black-forest-labs/FLUX.1-Krea-dev`、`MusePublic/majicMIX_realistic`、`MusePublic/14_ckpt_SD_XL`）。它们共用魔搭 API-Inference 的同一套端点与参数，差异只有 model ID、尺寸上限和魔粒档位，因此不单独建文件，统一记在 [供应商/魔搭.md](供应商/魔搭.md) 第 7 节。
-
-### SDK / Say-It 语音识别（15）
-
-以下 15 个模型均有独立 SDK capability descriptor 与按需执行模块；消费应用仍需显式导入和注册，升级包版本不会自动增加界面入口。火山文件版只接受供应商可访问的公网 URL，Say-It 在没有受管上传/TOS 之前不得把它伪装成本地文件入口。
-
-| 模型 | 模式 | 主协议 | 上限 | 文档 |
-|---|---|---|---|---|
-| `fun-asr-realtime-2026-02-28` | 实时 | WebSocket `run-task` | 时长无限制 | [百炼](Fun-ASR-Realtime-2026-02-28/Fun-ASR-Realtime-2026-02-28_百炼.md) |
-| `fun-asr-realtime` | 实时稳定别名 | WebSocket `run-task` | 时长无限制 | [百炼](Fun-ASR-Realtime/Fun-ASR-Realtime_百炼.md) |
-| `qwen3-asr-flash-realtime-2026-02-10` | 实时 | WebSocket session | 时长无限制 | [百炼](Qwen3-ASR-Flash-Realtime-2026-02-10/Qwen3-ASR-Flash-Realtime-2026-02-10_百炼.md) |
-| `qwen3-asr-flash-realtime` | 实时稳定别名 | WebSocket session | 时长无限制 | [百炼](Qwen3-ASR-Flash-Realtime/Qwen3-ASR-Flash-Realtime_百炼.md) |
-| `fun-asr-flash-2026-06-15` | 短音频 | DashScope HTTP/SSE 同步 | 5 分钟 / 2 GB | [百炼](Fun-ASR-Flash-2026-06-15/Fun-ASR-Flash-2026-06-15_百炼.md) |
-| `qwen3-asr-flash` | 短音频稳定别名 | OpenAI 兼容 / DashScope 同步 | 5 分钟 / 10 MB | [百炼](Qwen3-ASR-Flash/Qwen3-ASR-Flash_百炼.md) |
-| `qwen3-asr-flash-2026-02-10` | 短音频快照 | OpenAI 兼容 / DashScope 同步 | 5 分钟 / 10 MB | [百炼](Qwen3-ASR-Flash-2026-02-10/Qwen3-ASR-Flash-2026-02-10_百炼.md) |
-| `fun-asr` | 文件异步 | 提交 + 轮询 + 结果 JSON | 12 小时 / 2 GB | [百炼](Fun-ASR/Fun-ASR_百炼.md) |
-| `qwen3-asr-flash-filetrans` | 文件异步 | 提交 + 轮询 | 12 小时 / 2 GB | [百炼](Qwen3-ASR-Flash-Filetrans/Qwen3-ASR-Flash-Filetrans_百炼.md) |
-| `seedasr-2.0-realtime` | 实时 | 火山二进制 WebSocket | PCM S16LE / 16kHz / mono | [火山引擎](SeedASR-2.0-Realtime/SeedASR-2.0-Realtime_火山引擎.md) |
-| `seedasr-2.0-file` | 文件异步 | HTTP submit + query | 仅公网 URL；本地文件需外部 TOS/受管上传 | [火山引擎](SeedASR-2.0-File/SeedASR-2.0-File_火山引擎.md) |
-| `FunAudioLLM/SenseVoiceSmall` | 文件同步 | multipart HTTP | 1 小时 / 50 MB | [硅基流动](SenseVoiceSmall/SenseVoiceSmall_硅基流动.md) |
-| `TeleAI/TeleSpeechASR` | 文件同步 | multipart HTTP | 1 小时 / 50 MB | [硅基流动](TeleSpeechASR/TeleSpeechASR_硅基流动.md) |
-| `whisper-large-v3-turbo` | 文件同步 | OpenAI-compatible multipart | 免费层 25 MB；Developer 100 MB | [Groq](Whisper-Large-v3-Turbo/Whisper-Large-v3-Turbo_Groq.md) |
-| `whisper-large-v3` | 文件同步 | OpenAI-compatible multipart | 免费层 25 MB；Developer 100 MB | [Groq](Whisper-Large-v3/Whisper-Large-v3_Groq.md) |
-
-### Say-It 翻译（3）
-
-| 模型 | 流式语义 | 北京原价（输入/输出，每百万 Token） | 文档 |
-|---|---|---|---|
-| `qwen-mt-flash` | 增量 | 0.7 / 1.95 元 | [百炼](Qwen-MT-Flash/Qwen-MT-Flash_百炼.md) |
-| `qwen-mt-plus` | 累积序列 | 1.8 / 5.4 元 | [百炼](Qwen-MT-Plus/Qwen-MT-Plus_百炼.md) |
-| `qwen-mt-lite` | 增量 | 0.6 / 1.6 元 | [百炼](Qwen-MT-Lite/Qwen-MT-Lite_百炼.md) |
-
-### SDK LLM（2）
-
-| 模型 | 供应商 | 备注 | 文档 |
-|---|---|---|---|
-| `openai/gpt-oss-20b` | Groq | Say-It 默认；`reasoning_effort=low/medium/high`；不支持 `reasoning_format` | [Groq](GPT-OSS-20B/GPT-OSS-20B_Groq.md) |
-| `glm-5.3-flash` | 智谱 | 原生多模态 Chat 模型；1M 上下文 / 128K 输出；完整能力仍有官方冲突项 | [智谱](GLM-5.3-Flash/GLM-5.3-Flash_智谱.md) |
-
-## 四、平台模型 ID 速查
-
-### 可选工具模型
-
-| 工具 | Fal endpoint ID | SDK 入口 |
-|---|---|---|
-| Flux Pro Erase | `fal-ai/flux-pro/v1/erase` | `tool-models/fal/flux-pro-erase` |
-| Bria Eraser | `fal-ai/bria/eraser` | `tool-models/fal/bria-eraser` |
-| Finegrain Eraser (Mask) | `fal-ai/finegrain-eraser/mask` | `tool-models/fal/finegrain-eraser` |
-| Qwen Image Edit 2511 多角度 | `fal-ai/qwen-image-edit-2511-multiple-angles` | `@henjicc/ai-sdk/tool-models/fal/qwen-image-edit-2511-multiple-angles` |
-| 透视变换 | `fal-ai/image-apps-v2/perspective` | `@henjicc/ai-sdk/tool-models/fal/perspective-change` |
-| Image Apps v2 重打光 | `fal-ai/image-apps-v2/relighting` | `tool-models/fal/relighting` |
-| ControlLight | `fal-ai/control-light` | `tool-models/fal/control-light` |
-| Image Apps v2 扩图 | `fal-ai/image-apps-v2/outpaint` | `tool-models/fal/outpaint` |
-| Image Apps v2 商品摄影 | `fal-ai/image-apps-v2/product-photography` | `tool-models/fal/product-photography` |
-| Image Apps v2 照片修复 | `fal-ai/image-apps-v2/photo-restoration` | `tool-models/fal/photo-restoration` |
-| Pixelcut 背景移除 | `pixelcut/background-removal` | `tool-models/fal/pixelcut-background-removal` |
-| FLUX 2 多角度 | `fal-ai/flux-2-lora-gallery/multiple-angles` | `tool-models/fal/flux-2-multiple-angles` |
-
-- 3 个消除工具聚合为 `@henjicc/ai-sdk/tool-packs/fal-image-edit-tools`，统一能力画像为 `operation=image-edit`、`feature=erase`。
-- 6 个重打光/修复/扩图/商品/抠图工具聚合为 `@henjicc/ai-sdk/tool-packs/fal-image-utility-tools`，再按单模型画像区分具体能力。
-- Qwen 2509、透视变换和 FLUX 2 聚合为 `@henjicc/ai-sdk/tool-packs/fal-multi-angle-tools`，与消除和实用工具 pack 分开分发。
-
-三个 pack 都只是静态分发集合，执行继续走同一生成客户端和 Fal 公共协议。
-
-| 模型 | APIMart | KIE | Fal |
-|---|---|---|---|
-| Seedream 5.0 Pro | `seedream-5-0-pro` | `seedream/5-pro-text-to-image`、`5-pro-image-to-image`、`5-pro-layer-decomposition` | `bytedance/seedream/v5/pro/{text-to-image,edit}` |
-| Seedream 5.0 Lite | `seedream-5-0-lite` | `seedream/5-lite-text-to-image`、`5-lite-image-to-image` | `bytedance/seedream/v5/lite/{text-to-image,edit}` |
-| Qwen Image 3.0 | `qwen-image-3.0`、`qwen-image-3.0-pro` | `qwen3/{text-to-image,image-to-image}`、`qwen3-pro/text-to-image`、`qwen3/pro-image-to-image` | `alibaba/qwen-image-3/{text-to-image,edit}` |
-| Z-Image Turbo | `z-image-turbo` | `z-image` | `fal-ai/z-image/turbo`、`fal-ai/z-image/turbo/image-to-image`；魔搭 `Tongyi-MAI/Z-Image-Turbo` |
-| GPT-Image-2 | `gpt-image-2`（别名 `gpt-image-2-ext`）、`gpt-image-2-official` | `gpt-image-2-text-to-image`、`gpt-image-2-image-to-image` | `openai/gpt-image-2`、`openai/gpt-image-2/edit` |
-| IC-Light v2 | — | — | `fal-ai/iclight-v2` |
-| Topaz 图片放大 | — | — | `topaz/upscale/image/{precision,creative,generative}` |
-| Topaz 透明图放大 | — | — | `topaz/upscale/image/transparent` |
-| SeedVR2 图片放大 | — | — | `fal-ai/seedvr/upscale/image` |
-| Bria 创意放大 | — | — | `bria/upscale/creative` |
-| Ideogram 图片放大 | — | — | `fal-ai/ideogram/upscale` |
-| Nano Banana 2 | `gemini-3.1-flash-image-preview`(-official) | `nano-banana-2` | `fal-ai/nano-banana-2`、`fal-ai/nano-banana-2/edit` |
-| Nano Banana 2 Lite | `gemini-3.1-flash-lite-image`(-ext) | `nano-banana-2-lite` | ❌ 无（已探测确认） |
-| Nano Banana Pro | `gemini-3-pro-image-preview`(-official) | `nano-banana-pro` | `fal-ai/nano-banana-pro`、`fal-ai/nano-banana-pro/edit` |
-| Midjourney | `midjourney`（Imagine）、`midjourney-blend`、`midjourney-edit`、`midjourney-video`（新路由均自动注入平台模型 ID） | — | — |
-| Grok Imagine 2.0 | `grok-imagine-2.0-ext`、`grok-imagine-image-2.0` | `grok-imagine-image-2-0/{text-to-image,image-edit,segment-map,segment-edit}` | `xai/grok-imagine-image/v2.0/{text-to-image,edit}` |
-| Grok Imagine | — | `grok-imagine/{text-to-image,image-to-image}` | — |
-| Seedance 2.0 | `seedance-2.0` | `bytedance/seedance-2` | `bytedance/seedance-2.0/{text-to-video,image-to-video,reference-to-video}` |
-| Seedance 2.0 Fast | `seedance-2.0-fast` | `bytedance/seedance-2-fast` | `bytedance/seedance-2.0/fast/...` |
-| Seedance 2.0 Mini | `seedance-2.0-mini` | `bytedance/seedance-2-mini` | `bytedance/seedance-2.0/mini/...` |
-| Seedance 2.5 | `seedance-2.5` | `bytedance/seedance-2-5` | `bytedance/seedance-2.5/...` |
-| MiniMax H3 | `MiniMax-H3`、`MiniMax-H3-Context-IR`、`MiniMax-H3-Regeneration` | `minimax-h3/{text-to-video,image-to-video,reference-to-video}` | `minimax/h3/{text-to-video,image-to-video,reference-to-video}` |
-| MiniMax Hailuo 2.3 | — | `hailuo/2-3-image-to-video-{standard,pro}` | `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` |
-| MiniMax Hailuo 02 | — | `hailuo/02-{text,image}-to-video-{standard,pro}` | `fal-ai/minimax/hailuo-02/{standard,pro}/{text-to-video,image-to-video}`、`fal-ai/minimax/hailuo-02-fast/image-to-video` |
-| Kling 3.0 | `kling-v3` | `kling-3.0/video` | `fal-ai/kling-video/v3/{pro,standard}/...`；派欧云 `/v3/async/kling-v3.0-{std,pro,4k}-{t2v,i2v}` |
-| Kling 3.0 Turbo | `kling-3.0-turbo` | `kling/v3-turbo-{text,image}-to-video` | `fal-ai/kling-video/v3/turbo/{pro,standard}/...` |
-| Kling 3.0 Omni | `kling-v3-omni` | `kling-3.0-omni/{text-to-video,image-to-video,reference-to-video,transformation}` | `fal-ai/kling-video/o3/{pro,standard}/...` |
-| Gemini Omni Flash | `gemini-omni-flash-preview`、`Omni-Flash-Ext` | `gemini-omni-video` + `/api/v1/omni/audio/create` + `/api/v1/omni/character/create` | `google/gemini-omni-flash/{image-to-video,reference-to-video}` |
-
-Grsai 的平台模型 ID 未并入本表：它把「渠道」直接编码进 `model` 字段（如 `nano-banana-2-cl`、`gpt-image-2-vip`），渠道数量比 APIMart/KIE/Fal 常见的 2 档更多（GPT-Image-2 2 个、Nano Banana 2 主模型 4 个、Nano Banana 2 Lite 1 个、Nano Banana Pro 5 个），完整枚举见对应模型文档：[GPT-Image-2_Grsai.md](GPT-Image-2/GPT-Image-2_Grsai.md)、[Nano-Banana-2_Grsai.md](Nano-Banana-2/Nano-Banana-2_Grsai.md)、[Nano-Banana-2-Lite_Grsai.md](Nano-Banana-2-Lite/Nano-Banana-2-Lite_Grsai.md)、[Nano-Banana-Pro_Grsai.md](Nano-Banana-Pro/Nano-Banana-Pro_Grsai.md)。
-
-## 五、供应商通用协议速查
-
-| 供应商 | Base URL | 鉴权 | 提交 | 查询 | 结果字段 |
-|---|---|---|---|---|---|
-| **火山引擎** | 方舟 `https://ark.cn-beijing.volces.com`；语音 `https://openspeech.bytedance.com` | 方舟 Bearer；语音 `X-Api-Key` + Resource/Request ID | 图片同步；SeedASR 实时 WSS；文件 `POST /api/v3/auc/bigmodel/submit` | 文件 `POST /api/v3/auc/bigmodel/query` | 图片 `data[]`；ASR `result.text/utterances[]` |
-| **百炼** | `https://{WorkspaceId}.<region>.maas.aliyuncs.com` | `Authorization: Bearer sk-xxxx` | 生成/短 ASR/Qwen-MT 为同步 HTTP；实时 ASR 为 `/api-ws/v1/inference` 或 `/api-ws/v1/realtime` WSS；文件 ASR 为 `POST /api/v1/services/audio/asr/transcription` + `X-DashScope-Async: enable` | 异步 `GET /api/v1/tasks/{task_id}` | 按能力分为图像 `content[].image`、转写事件/文本、`transcription_url`、翻译 `choices[].message.content` |
-| **Groq** | `https://api.groq.com/openai/v1` | `Authorization: Bearer <GROQ_API_KEY>` | `POST /chat/completions`（同步/SSE）；`POST /audio/transcriptions`；`GET /models` | — | Chat choices/delta；ASR `text/language/duration/segments/words` |
-| **硅基流动** | `https://api.siliconflow.cn/v1` | `Authorization: Bearer <API Key>` | `POST /audio/transcriptions` multipart | — | `text`；响应头 `x-siliconcloud-trace-id` |
-| **智谱** | 国内 `https://open.bigmodel.cn/api/paas/v4`；国际 `https://api.z.ai/api/paas/v4` | `Authorization: Bearer <API Key>`；两区凭据分离 | `POST /chat/completions`（同步/SSE） | — | `choices[].message.content/reasoning_content/tool_calls`；流式 `choices[].delta` |
-| **APIMart** | `https://api.apimart.ai`；大陆备用线路见[基础文档](供应商/APIMart.md) | `Authorization: Bearer <KEY>` | `POST /v1/images/generations`、`POST /v1/videos/generations` | `GET /v1/tasks/{task_id}` | `result.images[]` / `result.videos[]` |
-| **KIE** | `https://api.kie.ai` | `Authorization: Bearer <KEY>` | `POST /api/v1/jobs/createTask` | `GET /api/v1/jobs/recordInfo?taskId=` | `JSON.parse(resultJson).resultUrls` |
-| **Fal** | `https://fal.run` / `https://queue.fal.run` | `Authorization: Key $FAL_KEY` | `POST https://queue.fal.run/<endpoint-id>` | `GET .../requests/{id}/status`、`GET .../requests/{id}` | `images[]` / `video` |
-| **派欧云** | `https://api.ppio.com/v3`（代码仍用旧域名 `api.ppinfra.com`，待核实） | `Authorization: Bearer <KEY>` | `POST /v3/async/<route>` | `GET /v3/async/task-result?task_id=` | `images[].image_url` / `videos[].video_url` / `audios[].audio_url`（TTL 3600s） |
-| **魔搭** | `https://api-inference.modelscope.cn` | `Authorization: Bearer <TOKEN>` | `POST /v1/images/generations` + 头 `X-ModelScope-Async-Mode: true`（代码写的是 `/api/v1/jobs/createTask`，待核实） | `GET /v1/tasks/{task_id}` + 头 `X-ModelScope-Task-Type: image_generation` | `output_images[]` |
-| **Grsai** | `https://grsaiapi.com`（全球）/ `https://grsai.dakka.com.cn`（国内直连，已接入连通性探测+自动切换） | `Authorization: Bearer <API Key>` | `POST /v1/api/generate`（`replyType` 项目侧统一强制 `async`） | `GET /v1/api/result?id=` | `results[].url` |
-
-任务状态枚举：
-- APIMart：`pending` / `processing` / `completed` / `failed` / `cancelled`（Midjourney 另有 MJ 风格状态 `NOT_START` / `SUBMITTED` / `IN_PROGRESS` / `MODAL` / `SUCCESS` / `FAILURE`）
-- KIE：`waiting` / `queuing` / `generating` / `success` / `fail`
-- Fal：`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`
-- 百炼异步：`PENDING` / `RUNNING` / `SUCCEEDED` / `FAILED` / `CANCELED` / `UNKNOWN`
-- 火山文件 ASR：响应头 `20000002` 排队 / `20000001` 处理中 / `20000000` 成功；`20000003` 静音终态；`45/55*` 失败
-- 派欧云：`TASK_STATUS_QUEUED` / `TASK_STATUS_PROCESSING` / `TASK_STATUS_SUCCEED` / `TASK_STATUS_FAILED`
-- 魔搭：`SUCCEED` / `FAILED`
-- Grsai：`running` / `violation`（违规，独立终态）/ `succeeded` / `failed`
-
-## 六、常用外部入口
-
-| 用途 | 链接 | 是否需登录 |
-|---|---|---|
-| APIMart 文档总索引 | https://docs.apimart.ai/llms.txt | 否 |
-| APIMart 定价中心 | https://apimart.ai/zh/pricing | 否 |
-| KIE 文档总索引 | https://docs.kie.ai/llms.txt | 否 |
-| KIE 定价页 | https://kie.ai/pricing | 否 |
-| Fal 平台总览 | https://fal.ai/llms.txt | 否 |
-| Fal 单模型 schema | `https://fal.ai/models/<endpoint-id>/llms.txt` | 否 |
-| 火山方舟图片生成 API | https://www.volcengine.com/docs/82379/1541523 | 否 |
-| 火山方舟模型价格 | https://www.volcengine.com/docs/82379/1544106 | 否 |
-| 火山 SeedASR 实时 WebSocket | https://docs.volcengine.com/docs/6561/2630027?lang=zh | 否 |
-| 火山 SeedASR 文件 submit/query | https://docs.volcengine.com/docs/6561/1354868?lang=zh | 否 |
-| 火山 SeedASR 价格/免费额度 | https://docs.volcengine.com/docs/6561/1359369?lang=zh | 否 |
-| 百炼模型价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
-| 百炼 ASR 模型与音频规格 | https://help.aliyun.com/zh/model-studio/asr-model/ | 否 |
-| 百炼 Qwen-MT API | https://help.aliyun.com/zh/model-studio/qwen-mt-api | 否 |
-| Groq 模型/价格 | https://console.groq.com/docs/models | 否 |
-| Groq API 参考 | https://console.groq.com/docs/api-reference | 否 |
-| Groq Reasoning | https://console.groq.com/docs/reasoning | 否 |
-| Groq Speech-to-Text | https://console.groq.com/docs/speech-to-text | 否 |
-| 硅基流动音频转写 API | https://api-docs.siliconflow.cn/docs/api/audio-transcriptions-post | 否 |
-| 硅基流动价格 | https://siliconflow.cn/pricing | 否 |
-| 可灵官方视频能力地图（仅参考） | https://www.klingai.com/document-api/guides/capability-map/video | 否 |
-| 派欧云文档索引 | https://ppio.com/docs/llms.txt | 否 |
-| 派欧云定价页 | https://ppio.com/pricing | 否 |
-| 魔搭 API-Inference 文档 | https://www.modelscope.cn/docs/model-service/API-Inference/intro | 否 |
-| 魔搭魔粒说明 | https://www.modelscope.cn/docs/magicube/intro | 否 |
-| APIMart API Key | https://apimart.ai/keys | **是** |
-| KIE API Key | https://kie.ai/api-key | **是** |
-| Fal API Key | https://fal.ai/dashboard/keys | **是** |
-| 火山方舟 API Key | https://console.volcengine.com/ark/region:cn-beijing/apiKey | **是** |
-| 百炼 API Key | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |
-| Groq API Key | https://console.groq.com/keys | **是** |
-| 硅基流动 API Key | https://cloud.siliconflow.cn/account/ak | **是** |
-| 智谱 GLM-5.3-Flash 模型/API | https://docs.bigmodel.cn/cn/guide/models/vlm/glm-5.3-flash | 否 |
-| 智谱模型价格 | https://open.bigmodel.cn/pricing | 否 |
-| 国际 Z.AI GLM-5.3-Flash | https://docs.z.ai/guides/vlm/glm-5.3-flash | 否 |
-| 国际 Z.AI 模型价格 | https://docs.z.ai/guides/overview/pricing | 否 |
-| Grsai 文档总索引（llms.txt） | https://qmy27nhsd9.apifox.cn/llms.txt | 否 |
-| Grsai dashboard 模型列表（权威价格） | https://grsai.com/zh/dashboard/models | 否 |
-| Grsai dashboard 公告（渠道调价历史） | https://grsai.com/zh/dashboard/announcements | 否 |
-| Grsai API Key | https://grsai.ai/zh/dashboard/api-keys | **是** |
-
-## 七、维护方式
-
-- **动手前**：先读 [文档采集手册.md](文档采集手册.md)——官方来源、流式事件矩阵、fixture/parser 测试闭环和 SDK 首发顺序的详细门槛只维护在这里
-- **新增模型**：在本文件的清单表里加一行 → 建同名文件夹 → 为每个支持它的供应商写一份 `<模型名>_<供应商名>.md`
-- **更新已有模型**：直接改对应的供应商文件，并更新该文件头部的「最后更新」以及本文件的「最后更新」
-- **信息来源要求**：每条参数 / 价格都要能追溯到文件末尾「原始链接索引」中的某个链接；需要登录才能看到的页面必须标注
+# 模型适配清单（总索引）
+
+本目录是**痕迹AI 的模型适配唯一资料源**。Henji-AI 同时是 `@henjicc/ai-sdk` 的主开发仓库与首发验证宿主；官方调研、实现和完整验证先在这里闭环，发布后消费项目才精确锁版本接入。适配思路已从「挑一个供应商、把它的模型尽量做全」调整为：
+**先定一份常用且优秀的模型清单，再为清单里的每个模型逐一接入所有支持它的供应商。**
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-08 |
+| 模型数量 | 生成主清单 20（图片 11 / 视频 9）+ 主清单外存量 12 + SDK 跨项目能力模型 25（ASR 20 / 翻译 3 / LLM 2） |
+| 模型供应商文档数量 | 生成/存量 83 + SDK 跨项目能力 19（另有 Fal 工具 12） |
+| 覆盖供应商 | 火山引擎（官方生成/ASR）、百炼（官方）、硅基流动（官方 ASR）、智谱（官方 LLM）、Groq（官方 LLM/ASR）、APIMart、KIE、Fal、派欧云、魔搭、Grsai |
+
+另有 12 个按能力按需分发的 Fal 图像工具，不进入默认 124 模型兼容目录：
+
+- 消除：[Flux Pro Erase](Flux-Pro-Erase/Flux-Pro-Erase_Fal.md)、[Bria Eraser](Bria-Eraser/Bria-Eraser_Fal.md)、[Finegrain Eraser](Finegrain-Eraser/Finegrain-Eraser_Fal.md)。
+- 图片实用工具：[Image Apps v2 重打光](Image-Apps-v2-重打光/Image-Apps-v2-重打光_Fal.md)、[ControlLight](ControlLight/ControlLight_Fal.md)、[Image Apps v2 扩图](Image-Apps-v2-扩图/Image-Apps-v2-扩图_Fal.md)、[Image Apps v2 商品摄影](Image-Apps-v2-商品摄影/Image-Apps-v2-商品摄影_Fal.md)、[Image Apps v2 照片修复](Image-Apps-v2-照片修复/Image-Apps-v2-照片修复_Fal.md)、[Pixelcut 背景移除](Pixelcut-背景移除/Pixelcut-背景移除_Fal.md)。
+- 多角度：[Qwen Image Edit 2511 多角度](Qwen-Image-Edit-2511-多角度/Qwen-Image-Edit-2511-多角度_Fal.md)、[透视变换](透视变换/透视变换_Fal.md)、[FLUX 2 多角度](FLUX-2-多角度/FLUX-2-多角度_Fal.md)。
+
+工具均复用 Fal 队列、上传与结果解析；它们是独立的按需 SDK 入口，不是新的执行内核。Henji-AI 运行客户端显式装载三个 pack，但普通模型选择器为 124 个默认模型：六个图片实用工具通过图片能力菜单创建固定模型节点，三个多角度工具由专用多角度节点选择，消除工具保留给后续遮罩能力接入。真实质量、延迟和账单仍待获得付费授权后验证。
+
+## 用户决策记录
+
+只记用户拍板的取舍，接手前先看；推翻时在原条目后补日期与新决定，不删旧条目。
+
+- **2026-11-07 KIE、Fal 的语音识别不接**：KIE Nemotron 3.5 Transcribe、Fal ElevenLabs Scribe v2 / Wizper 等都不做，语音识别留在百炼、火山、硅基流动、Groq 四家。
+- **2026-11-07 火山、百炼大语言模型做全**：预设覆盖官方清单里未下线的模型，包括两家托管的 DeepSeek、Kimi、GLM、MiniMax、MiMo、Step；即将下线与翻译专用模型不进预设。托管第三方在逐个核实前走 Chat。
+- **2026-11-07 语音识别只补资料齐全的**：已加百炼 Qwen-Audio 3.0；火山 1.0 极速版、闲时版不做（2.0 更便宜）；百炼 `qwen-audio-3.1-asr-flash-message` 等事件协议整理后再做；硅基流动星辰与 Qwen3-ASR 等官方 API 列出后再接。
+- **2026-11-07 生成模型第一批待定**：候选 GPT Image 2.6、Wan 3.0、Kling 4.0、Gemini Omni 1.2、火山官方 Seedance，用户未确认前不动。
+  - 同日用户改为“缺的都补上”：第一批（含火山官方 Seedance、百炼万相 3.0）及 FLUX 3、Grok Imagine Video 1.5、MiniMax H3 Max、LTX-2.3、Veo 3.1（APIMart）、Seedream 5.0 Flash（APIMart）、HappyHorse 1.1（APIMart）、Eleven v4、Gemini 3.8 TTS 已接入，见下方“2026-11-07 已适配更新”。
+- **2026-11-07 能力标签两层封闭词表**：标签只说“模型能做什么事”，一件事一个标签，词表只在 `src/types/modelTags.ts`。形态按输入输出判断（图片编辑是大类，参考生视频不等于视频编辑或延长，首尾帧必同时有图生视频）；专项只给有专门参数或接口的模型（打光、多角度、扩图、放大、老照片修复、图层拆分、局部重绘、擦除、透明背景等，抠图并入透明背景）。不要“带声音”；能传几张图、分辨率、供应商这类配置事实不做标签；“仅英文提示词”是使用限制，改成 `promptLanguage`。
+- **2026-11-08 Groq Orpheus 语音合成不接**：Orpheus 只有英语与沙特阿拉伯语，不支持中文，两个模型下线；Groq 只保留大语言模型与语音识别。
+- **2026-11-07 下线模型先标“已过时”不删代码**：平台已下线或即将下线的模型、派欧云全部生成模型（派欧云只保留大语言模型）写 `meta.deprecated`（大语言模型写目录条目的 `deprecated`），用户入口一律不再列出，开发者面板照常显示并注明原因。首批：Fal LTX-2、Fal Veo 3.1、火山 Seedream 5.0 Lite、KIE Seedance 1.5 Pro、派欧云 Kling 3.0 与 MiniMax Speech、Kimi K2.6 / K2.7 Code、MiMo 2.5。
+- **发布**：0.10.0 起的改动只接入痕迹AI，用户试过并明确要求后才发 npm（见 AGENTS.md 第 7 条）。
+
+## 2026-11-07 已适配更新
+
+全部只做了离线请求构建与价格核对，没有真实付费生成；价格与出处见各模型文档。
+
+- [GPT Image 2.6](GPT-Image-2.6/)：[Fal](GPT-Image-2.6/GPT-Image-2.6_Fal.md)、[KIE](GPT-Image-2.6/GPT-Image-2.6_KIE.md)、[APIMart](GPT-Image-2.6/GPT-Image-2.6_APIMart.md)、[Grsai](GPT-Image-2.6/GPT-Image-2.6_Grsai.md)。
+- [FLUX 3](FLUX-3/)：[Fal](FLUX-3/FLUX-3_Fal.md)、[APIMart（含 Klein 版本）](FLUX-3/FLUX-3_APIMart.md)；[FLUX 3 Klein · KIE](FLUX-3-Klein/FLUX-3-Klein_KIE.md)。
+- [Seedream 5.0 Flash · APIMart](Seedream-5.0-Flash/Seedream-5.0-Flash_APIMart.md)。
+- [Kling 4.0](Kling-4.0/)：[Fal](Kling-4.0/Kling-4.0_Fal.md)、[KIE](Kling-4.0/Kling-4.0_KIE.md)、[APIMart](Kling-4.0/Kling-4.0_APIMart.md)；[Kling 4.0 Flash](Kling-4.0-Flash/)：[Fal](Kling-4.0-Flash/Kling-4.0-Flash_Fal.md)、[KIE](Kling-4.0-Flash/Kling-4.0-Flash_KIE.md)。分镜与元素：Fal 标准版两者都支持，Fal Flash 与 KIE（标准版、Flash）仅支持元素，APIMart 两者都不支持（官方返回 400）。
+- [Wan 2.7 Image · APIMart](Wan-2.7-Image/Wan-2.7-Image_APIMart.md)（标准版 / Pro）。
+- [FLUX 3 Video](FLUX-3-Video/)：[APIMart](FLUX-3-Video/FLUX-3-Video_APIMart.md)、[Fal（含 FLUX 3 Max）](FLUX-3-Video/FLUX-3-Video_Fal.md)；两家都支持草稿与草稿转正片（模型 `continuations`）。
+- 续接生成（模型 `continuations`）：FLUX 3 Video 草稿转正片、Midjourney 图转视频（APIMart）、Gemini Omni 1.2 Flash 续写（APIMart）。
+- [Wan 3.0](Wan-3.0/)：[Fal](Wan-3.0/Wan-3.0_Fal.md)、[APIMart](Wan-3.0/Wan-3.0_APIMart.md)（两家 Prime 为版本选项）、[KIE](Wan-3.0/Wan-3.0_KIE.md)、[Grsai](Wan-3.0/Wan-3.0_Grsai.md)；[Wan 3.0 Prime · KIE](Wan-3.0-Prime/Wan-3.0-Prime_KIE.md)。
+- [Gemini Omni 1.2 Flash](Gemini-Omni-1.2-Flash/)：[Fal](Gemini-Omni-1.2-Flash/Gemini-Omni-1.2-Flash_Fal.md)、[APIMart](Gemini-Omni-1.2-Flash/Gemini-Omni-1.2-Flash_APIMart.md)。
+- [Grok Imagine Video 1.5](Grok-Imagine-Video-1.5/)：[Fal](Grok-Imagine-Video-1.5/Grok-Imagine-Video-1.5_Fal.md)、[KIE](Grok-Imagine-Video-1.5/Grok-Imagine-Video-1.5_KIE.md)、[APIMart](Grok-Imagine-Video-1.5/Grok-Imagine-Video-1.5_APIMart.md)。
+- [MiniMax H3 Max](MiniMax-H3-Max/)：[Fal](MiniMax-H3-Max/MiniMax-H3-Max_Fal.md)、[APIMart](MiniMax-H3-Max/MiniMax-H3-Max_APIMart.md)。
+- [LTX-2.3 · Fal](LTX-2.3/LTX-2.3_Fal.md)（取代已过时的 LTX-2；含音频生视频 `fal-ai/ltx-2.3/audio-to-video`）、[Veo 3.1 · APIMart](Veo-3.1/Veo-3.1_APIMart.md)（Fal 的 Veo 3.1 11-17 下线）、[HappyHorse 1.1 · APIMart](HappyHorse-1.1/HappyHorse-1.1_APIMart.md)。
+- 官方直连：火山方舟 Seedance [2.5](Seedance-2.5/Seedance-2.5_火山引擎.md)、[2.0](Seedance-2.0/Seedance-2.0_火山引擎.md)、[2.0 Fast](Seedance-2.0-Fast/Seedance-2.0-Fast_火山引擎.md)、[2.0 Mini](Seedance-2.0-Mini/Seedance-2.0-Mini_火山引擎.md)；[百炼万相 3.0（含 Prime 高速版）](Wan-3.0/Wan-3.0_百炼.md)、[百炼 MiniMax H3](MiniMax-H3/MiniMax-H3_百炼.md)。两家官方供应商新增异步任务提交与轮询。
+- 语音：[Eleven v4 · Fal](Eleven-v4/Eleven-v4_Fal.md)、[Gemini 3.8 Flash TTS · KIE](Gemini-3.8-Flash-TTS/Gemini-3.8-Flash-TTS_KIE.md)、[Gemini 3.8 Flash-Lite TTS · KIE](Gemini-3.8-Flash-Lite-TTS/Gemini-3.8-Flash-Lite-TTS_KIE.md)（按原价估，限时价到 2026-12-31）、[Qwen Audio 3.1 TTS Plus · 百炼](Qwen-Audio-3.1-TTS-Plus/Qwen-Audio-3.1-TTS-Plus_百炼.md)。
+- 已过时（用户界面不再列出，文档保留）：LTX-2 · Fal、Veo 3.1 · Fal、Seedream 5.0 Lite · 火山方舟、Seedance 1.5 Pro · KIE、派欧云 Kling 3.0 与 MiniMax Speech。
+
+## 2026-09-27 TTS 适配
+
+2026-10-12：[TTS 时间戳逐接口核实（t177）](TTS-时间戳-2026-10.md) 记录全部现有 TTS 接口的支持范围、开启参数、计费证据和资料缺口；Seed-TTS / ICL 2.0 原生字时间戳进入公共生成元数据，未切换 Qwen/CosyVoice 协议。
+
+2026-09-28：[豆包语音 2.0](Seed-ICL-2.0/Seed-ICL-2.0_火山引擎.md) 提供语音合成 / 克隆声音两模式，内置官方 431 个系统音色，并按系统/克隆音色选择 TTS/ICL 资源。接入官方 V3 训练与查询、自动后付费音色编号、克隆提交费用二次确认、试听和首次合成费用确认；Seed-TTS / ICL 2.0 公开价格更新为 3 元/万字符。
+
+[TTS 多供应商适配契约](TTS-多供应商-2026-09.md)：新增 13 个文字转语音模型，覆盖 Fal、百炼、KIE、硅基流动与火山语音；派欧云 MiniMax Speech 2.8 继续使用已有接入。记录官方接口、价格、音色前提、流式响应和测试样本来源。
+
+2026-09-27 补充官方音色目录及账号查询接口：Qwen Audio 3.1、Seed-TTS 2.0 使用核对后的预置清单；百炼 MiniMax / Qwen / CosyVoice 与硅基流动 CosyVoice2 支持按账号查询可用音色。接口字段、适用模型和不可查询渠道的边界见上方契约。
+
+2026-10-12 外部 MCP 实测复核：KIE Turbo 音色 ID、百炼未开通错误与 TTS 估价依据及待确认边界见 [TTS 契约的 t168 复核](TTS-多供应商-2026-09.md#2026-10-12-外部-mcp-实测复核t168)。
+
+## 2026-09-24 已适配更新
+
+- [HappyHorse 1.1 · KIE](HappyHorse-1.1/HappyHorse-1.1_KIE.md)：文生、图生与多图参考。
+- [Seedream 5.0 Flash · 火山方舟](Seedream-5.0-Flash/Seedream-5.0-Flash_火山引擎.md)：生成、编辑与图层拆分。
+- [GLM Flash / FlashX](GLM-5.3-Flash/GLM-5.3-Flash_智谱.md)：新增 FlashX 与 JSON 契约。
+- [百炼 ASR](供应商/百炼.md)：新增 Qwen-Audio 3.1 三种语音识别协议预设。
+- [MiMo 2.6 与 Responses](../llm-adaptation/供应商/小米MiMo.md)、[Kimi 缓存价格](../llm-adaptation/供应商/Kimi.md)。
+
+## 一、目录结构约定
+
+### 文本 Embedding / Rerank（2026-09-11）
+
+SDK 使用独立 `capabilities/embedding/<provider>` 与 `capabilities/rerank/<provider>` 入口，显式注册到能力客户端和发现目录，不混入图片生成目录。
+
+| 供应商 | Embedding | Rerank | 协议资料 |
+|---|---|---|---|
+| 硅基流动 | Qwen3 8B/4B/0.6B、BGE-M3 | Qwen3 8B/4B/0.6B、BGE v2 M3 | [供应商资料](供应商/硅基流动.md) |
+| 百炼 | Qwen3.7、Qwen3.7 Flash、v4 | Qwen3.7、Qwen3、GTE v2 | [供应商资料](供应商/百炼.md) |
+| 派欧云 | BGE-M3 | BGE v2 M3 | [供应商资料](供应商/派欧云.md) |
+| 智谱 | embedding-3 | rerank | 见下方官方依据 |
+| 火山方舟 | Doubao Embedding Vision 251215（文本单条） | VikingDB 独立服务暂未适配 | [供应商资料](供应商/火山引擎.md) |
+
+智谱直接依据：[Embedding API](https://docs.bigmodel.cn/api-reference/模型-api/文本嵌入)、[Embedding-3 模型](https://docs.bigmodel.cn/cn/guide/models/embedding/embedding-3)、[Rerank API](https://docs.bigmodel.cn/api-reference/模型-api/文本重排序)、[公开价格](https://bigmodel.cn/pricing)。国内根地址 `https://open.bigmodel.cn`，Bearer。Embedding POST `/api/paas/v4/embeddings`，model=embedding-3，input 字符串数组，最多 64 条，dimensions=256/512/1024/2048；返回 data 数组的 index/embedding。字段表限制每条 3072 tokens，概述 8K 表述存在冲突，不用字符数猜 token 限制。Rerank POST `/api/paas/v4/rerank`，model=rerank，query/documents/top_n；最多 128 条，每条及 query 最多 4096 字符；返回 results 的 index/relevance_score。省略 top_n 返回全部；SDK 显式 topN 必须为正整数，超出候选数裁到候选数。文本从原输入索引回填。Embedding 公开价 0.5 元/百万 tokens，Rerank 搜索可见官方价格 0.8 元/百万 tokens，价格页运行时需要 JavaScript，实际账单以控制台为准。
+
+共同验证边界：非流式单次 HTTP；空结果、缺失/重复/越界索引、非数值向量/分数不当作成功。向量维度必须一致；显式要求维度必须匹配。HTTP 错误、JSON 错误、供应商 error/code、取消和超时均失败；不自动重试付费 POST，不记录原文或凭据。未做真实付费验证。
+
+其他现有供应商也进行了检索核对：[APIMart 官方 AnythingLLM 指南](https://docs.apimart.ai/cn/integrations/chat/anythingllm) 提及 text-embedding-3-small/large，但本轮未取到独立端点字段表与价格，保留待核验；[魔搭 API 推理介绍](https://modelscope.cn/docs/model-service/API-Inference/intro) 本次无法读取正文，模型仓库存在权重不等于托管 API 已开放。Groq、DeepSeek、Fal、KIE、Grsai 的公开入口搜索未获得足以适配这两类能力的完整契约，不据此断言平台不支持。
+
+```
+docs/model-adaptation/
+├── README.md                      # 本文件：总清单 + 索引
+├── 文档采集手册.md                  # 官方调研、事件契约、fixture 与 SDK 首发验证的唯一详细规范
+├── 供应商/                         # 先完成供应商公共协议，再做具体模型
+│   ├── 快速适配供应商.md             # 新供应商的统一核对与落地清单
+│   ├── APIMart.md
+│   ├── KIE.md
+│   ├── Fal.md
+│   ├── Groq.md
+│   ├── 硅基流动.md
+│   ├── 百炼.md
+│   ├── 火山引擎.md
+│   ├── 派欧云.md
+│   └── 魔搭.md
+├── <模型名>/                       # 一个模型一个文件夹
+│   └── <模型名>_<供应商名>.md       # 支持该模型的每个供应商一个文件
+```
+
+- **供应商名**使用项目内统一的显示名：
+  派欧云 / Fal / 魔搭 / KIE / APIMart / 百炼 / 火山引擎 / 硅基流动 / Grsai / Groq（Grsai/Groq 沿用官方品牌拼写）
+- 每个供应商文件都是**自包含**的：接入协议、能力清单、请求参数、响应结构、价格、适配要点、原始链接索引，看完这一份就能完成该供应商的适配
+- 每份文件都标注**信息来源链接**以及**该链接是否需要登录**
+
+### 供应商基础文档
+
+模型适配前先看 [快速适配供应商](供应商/快速适配供应商.md)，确认供应商公共层已经覆盖端点、鉴权、上传、任务查询、结果解析和计价。现有十家基础文档：
+
+- [APIMart](供应商/APIMart.md)：含中国大陆备用线路与图片上传协议
+- [KIE](供应商/KIE.md)：生成任务、文件上传、实际扣费与余额查询
+- [Fal](供应商/Fal.md)：同步 / 队列协议、Fal CDN、官方计价 API
+- [百炼](供应商/百炼.md)：地域端点、临时 OSS 上传与同步 / 异步边界
+- [火山引擎](供应商/火山引擎.md)：方舟图片，以及 SeedASR 2.0 实时/文件两套独立协议与计费
+- [硅基流动](供应商/硅基流动.md)：multipart 文件转写、免费模型与在线文档/历史公告冲突
+- [派欧云](供应商/派欧云.md)：异步任务协议、**无官方上传（借用 KIE）**、实名认证前置、在售清单极小
+- [魔搭](供应商/魔搭.md)：API-Inference 统一接口、**魔粒积分计费**、仅图片、可用性判定方法
+- [Grsai](供应商/Grsai.md)：聚合中转，**同一模型拆多个「渠道」**（`-cl`/`-vip`/`-vt`/`-lite` 等后缀，价差可达 10 倍以上）、无独立上传接口（图片直接 base64/URL 塞进请求体）、双线路连通性探测
+- [Groq](供应商/Groq.md)：OpenAI 兼容 LLM、Whisper 文件转写、动态模型发现、价格/免费层与错误边界
+- [智谱 GLM](../llm-adaptation/供应商/智谱GLM.md)：国内 BigModel / 国际 Z.AI 两个 endpoint profile、OpenAI 兼容 Chat 与供应商级思考约定；模型专属契约仍以本目录模型文件为准
+
+尚未适配的图片工具供应商候选统一记录在[图片工具候选供应商调研](供应商/候选供应商调研-图片工具.md)：当前优先级为 Segmind / WaveSpeedAI（P0）、PiAPI（P1）、Replicate（P2）、Novita AI（P3）；中国内地访问友好性均需真实网络验证，不能仅凭中文站或支付方式下结论。
+
+## 二、通用适配规则
+
+1. **默认绝对不显示的参数**：随机种子 `seed`、负面提示词。
+   即使供应商提供了这两个字段，也**不注册、不下发**。各文件的「适配要点」会逐一标出哪个供应商有这两个字段。
+2. **`output_format` 默认不显示且不请求**，保持供应商默认值。
+3. 价格以**供应商的定价页 / 模型 `llms.txt` / 任务返回的 `cost`** 为准；部分 API 文档正文中的价格已过期，出现不一致时文件内会同时列出两处并说明取舍。
+4. 各供应商同名参数的**默认值、取值集合、字段名经常不一致**（例如 `adaptive` vs `auto`、整数 `5` vs 字符串 `"5"`），必须按供应商分别声明 schema，不要共用常量。
+5. 价格依赖本地媒体像素、时长或文件指标时，由模型在 `pricing.mediaContext` 声明需求，宿主统一读取并注入 calculator；禁止在单个页面或画布节点复制媒体计价逻辑。指标未解析完成时不显示伪造的兜底总价。
+
+## 三、模型清单
+
+### 图片（11）
+
+| 模型 | 火山引擎 | 百炼 | APIMart | KIE | Fal | 派欧云 | 魔搭 | Grsai |
+|---|---|---|---|---|---|---|---|---|
+| [Seedream 5.0 Pro](Seedream-5.0-Pro/) | [✅ 官方](Seedream-5.0-Pro/Seedream-5.0-Pro_火山引擎.md) | — | [✅](Seedream-5.0-Pro/Seedream-5.0-Pro_APIMart.md) | [✅](Seedream-5.0-Pro/Seedream-5.0-Pro_KIE.md) | [✅](Seedream-5.0-Pro/Seedream-5.0-Pro_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
+| [Seedream 5.0 Lite](Seedream-5.0-Lite/) | [✅ 官方](Seedream-5.0-Lite/Seedream-5.0-Lite_火山引擎.md) | — | [✅](Seedream-5.0-Lite/Seedream-5.0-Lite_APIMart.md) | [✅](Seedream-5.0-Lite/Seedream-5.0-Lite_KIE.md) | [✅](Seedream-5.0-Lite/Seedream-5.0-Lite_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
+| [Qwen Image 3.0](Qwen-Image-3.0/) | — | [✅ 官方](Qwen-Image-3.0/Qwen-Image-3.0_百炼.md) | [✅](Qwen-Image-3.0/Qwen-Image-3.0_APIMart.md) | [✅](Qwen-Image-3.0/Qwen-Image-3.0_KIE.md) | [✅](Qwen-Image-3.0/Qwen-Image-3.0_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
+| [Z-Image Turbo](Z-Image-Turbo/) | — | [✅ 官方](Z-Image-Turbo/Z-Image-Turbo_百炼.md) | [✅](Z-Image-Turbo/Z-Image-Turbo_APIMart.md) | [✅](Z-Image-Turbo/Z-Image-Turbo_KIE.md) | [✅](Z-Image-Turbo/Z-Image-Turbo_Fal.md) | ❌ 无 | [✅](Z-Image-Turbo/Z-Image-Turbo_魔搭.md) | ❌ 无 |
+| [GPT-Image-2](GPT-Image-2/) | — | — | [✅](GPT-Image-2/GPT-Image-2_APIMart.md) | [✅](GPT-Image-2/GPT-Image-2_KIE.md) | [✅](GPT-Image-2/GPT-Image-2_Fal.md) | ❌ 无 | ❌ 无 | [✅](GPT-Image-2/GPT-Image-2_Grsai.md) |
+| [IC-Light v2](IC-Light-v2/) | — | — | ❌ 无 | ❌ 无 | [✅](IC-Light-v2/IC-Light-v2_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
+| [Nano Banana 2](Nano-Banana-2/) | — | — | [✅](Nano-Banana-2/Nano-Banana-2_APIMart.md) | [✅](Nano-Banana-2/Nano-Banana-2_KIE.md) | [✅](Nano-Banana-2/Nano-Banana-2_Fal.md) | ❌ 无 | ❌ 无 | [✅](Nano-Banana-2/Nano-Banana-2_Grsai.md) |
+| [Nano Banana 2 Lite](Nano-Banana-2-Lite/) | — | — | [✅](Nano-Banana-2-Lite/Nano-Banana-2-Lite_APIMart.md) | [✅](Nano-Banana-2-Lite/Nano-Banana-2-Lite_KIE.md) | ❌ 无（已探测确认，见 [Fal 文档说明](Nano-Banana-2/Nano-Banana-2_Fal.md)） | ❌ 无 | ❌ 无 | [✅](Nano-Banana-2-Lite/Nano-Banana-2-Lite_Grsai.md) |
+| [Nano Banana Pro](Nano-Banana-Pro/) | — | — | [✅](Nano-Banana-Pro/Nano-Banana-Pro_APIMart.md) | [✅](Nano-Banana-Pro/Nano-Banana-Pro_KIE.md) | [✅](Nano-Banana-Pro/Nano-Banana-Pro_Fal.md) | ❌ 无 | ❌ 无 | [✅](Nano-Banana-Pro/Nano-Banana-Pro_Grsai.md) |
+| [Midjourney](Midjourney/) | — | — | [✅](Midjourney/Midjourney_APIMart.md) | ❌ 无 | ❌ 无 | ❌ 无 | ❌ 无 | ❌ 无 |
+| [Grok Imagine 2.0](Grok-Imagine-2.0/) | — | — | [✅](Grok-Imagine-2.0/Grok-Imagine-2.0_APIMart.md) | [✅](Grok-Imagine-2.0/Grok-Imagine-2.0_KIE.md) | [✅](Grok-Imagine-2.0/Grok-Imagine-2.0_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
+
+**Nano Banana 2 Lite 是独立模型，不是 Nano Banana 2 的分辨率/渠道选项**：代码里两者 `canonicalModelId` 不同（`nano-banana-2` vs `nano-banana-2-lite`），`generationModelDescriptions.ts` 也各自维护一条独立描述，APIMart/KIE 均已用独立 `.model.ts` 文件实现，因此本表把它列为单独一行，不再挂在 Nano Banana 2 文档里。
+
+### 视频（9）
+
+| 模型 | APIMart | KIE | Fal | 派欧云 | 魔搭 | 火山方舟 |
+|---|---|---|---|---|---|---|
+| [Seedance 2.0](Seedance-2.0/) | [✅](Seedance-2.0/Seedance-2.0_APIMart.md) | [✅](Seedance-2.0/Seedance-2.0_KIE.md) | [✅](Seedance-2.0/Seedance-2.0_Fal.md) | ❌ 已下架 | ❌ 无 | [✅](Seedance-2.0/Seedance-2.0_火山引擎.md) |
+| [Seedance 2.0 Fast](Seedance-2.0-Fast/) | [✅](Seedance-2.0-Fast/Seedance-2.0-Fast_APIMart.md) | [✅](Seedance-2.0-Fast/Seedance-2.0-Fast_KIE.md) | [✅](Seedance-2.0-Fast/Seedance-2.0-Fast_Fal.md) | ❌ 已下架 | ❌ 无 | [✅](Seedance-2.0-Fast/Seedance-2.0-Fast_火山引擎.md) |
+| [Seedance 2.0 Mini](Seedance-2.0-Mini/) | [✅](Seedance-2.0-Mini/Seedance-2.0-Mini_APIMart.md) | [✅](Seedance-2.0-Mini/Seedance-2.0-Mini_KIE.md) | [✅](Seedance-2.0-Mini/Seedance-2.0-Mini_Fal.md) | ❌ 已下架 | ❌ 无 | [✅](Seedance-2.0-Mini/Seedance-2.0-Mini_火山引擎.md) |
+| [Seedance 2.5](Seedance-2.5/) | [✅](Seedance-2.5/Seedance-2.5_APIMart.md) | [✅](Seedance-2.5/Seedance-2.5_KIE.md) | [✅](Seedance-2.5/Seedance-2.5_Fal.md) | ❌ 已下架 | ❌ 无 | [✅](Seedance-2.5/Seedance-2.5_火山引擎.md) |
+| [MiniMax H3](MiniMax-H3/)（另有 [百炼](MiniMax-H3/MiniMax-H3_百炼.md)） | [✅](MiniMax-H3/MiniMax-H3_APIMart.md) | [✅](MiniMax-H3/MiniMax-H3_KIE.md) | [✅](MiniMax-H3/MiniMax-H3_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
+| [Kling 3.0](Kling-3.0/) | [✅](Kling-3.0/Kling-3.0_APIMart.md) | [✅](Kling-3.0/Kling-3.0_KIE.md) | [✅](Kling-3.0/Kling-3.0_Fal.md) | [已过时](Kling-3.0/Kling-3.0_派欧云.md) | ❌ 无 | ❌ 无 |
+| [Kling 3.0 Turbo](Kling-3.0-Turbo/) | [✅](Kling-3.0-Turbo/Kling-3.0-Turbo_APIMart.md) | [✅](Kling-3.0-Turbo/Kling-3.0-Turbo_KIE.md) | [✅](Kling-3.0-Turbo/Kling-3.0-Turbo_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
+| [Kling 3.0 Omni](Kling-3.0-Omni/) | [✅](Kling-3.0-Omni/Kling-3.0-Omni_APIMart.md) | [✅](Kling-3.0-Omni/Kling-3.0-Omni_KIE.md) | [✅](Kling-3.0-Omni/Kling-3.0-Omni_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
+| [Gemini Omni Flash](Gemini-Omni-Flash/) | [✅](Gemini-Omni-Flash/Gemini-Omni-Flash_APIMart.md) | [✅](Gemini-Omni-Flash/Gemini-Omni-Flash_KIE.md) | [✅](Gemini-Omni-Flash/Gemini-Omni-Flash_Fal.md) | ❌ 无 | ❌ 无 | ❌ 无 |
+
+2026-11-07 起火山方舟官方接入 Seedance 2.5 / 2.0 / 2.0 Fast / 2.0 Mini（参考视频因方舟不收 Base64 且无官方上传而不开放），百炼官方接入万相 3.0；Kling 官方接口按用户要求**仅作参考、暂不适配**（能力地图：https://www.klingai.com/document-api/guides/capability-map/video ）。
+
+Grsai 暂未在此表出现：其站内「Veo API」旧版文档给出了 `veo3.1-fast` 视频模型的端点，但该模型**未出现在 dashboard「模型列表」的定价清单中**，可用性与计价未确认，详见 [Grsai 基础文档 §8](供应商/Grsai.md)。
+
+### 主清单外存量模型（12）
+
+以下模型**不在主清单里**，但已在代码中适配并对用户开放，文档用于维护现有实现。部分模型已有多个供应商入口，未来是否纳入主清单待定。
+
+| 模型 | 模态 | 供应商 | 文档 |
+|---|---|---|---|
+| MiniMax Hailuo 2.3 | 视频 | KIE / Fal | [KIE](Hailuo-2.3/Hailuo-2.3_KIE.md) / [Fal](Hailuo-2.3/Hailuo-2.3_Fal.md) |
+| MiniMax Hailuo 02 | 视频 | KIE / Fal | [KIE](Hailuo-02/Hailuo-02_KIE.md) / [Fal](Hailuo-02/Hailuo-02_Fal.md) |
+| Grok Imagine | 图片 | KIE | [KIE](Grok-Imagine/Grok-Imagine_KIE.md) |
+| MiniMax Speech | 音频 | 派欧云 | [MiniMax-Speech_派欧云.md](MiniMax-Speech/MiniMax-Speech_派欧云.md) |
+| Topaz 图片放大 | 图片 | Fal | [Topaz-图片放大_Fal.md](Topaz-图片放大/Topaz-图片放大_Fal.md) |
+| Topaz 透明图放大 | 图片 | Fal | [Topaz-透明图放大_Fal.md](Topaz-透明图放大/Topaz-透明图放大_Fal.md) |
+| SeedVR2 图片放大 | 图片 | Fal | [SeedVR2-图片放大_Fal.md](SeedVR2-图片放大/SeedVR2-图片放大_Fal.md) |
+| Bria 创意放大 | 图片 | Fal | [Bria-创意放大_Fal.md](Bria-创意放大/Bria-创意放大_Fal.md) |
+| Ideogram 图片放大 | 图片 | Fal | [Ideogram-图片放大_Fal.md](Ideogram-图片放大/Ideogram-图片放大_Fal.md) |
+
+魔搭侧另有 5 个已适配的开源图像模型（`Qwen/Qwen-Image-2512`、`Qwen/Qwen-Image-Edit-2511`，旧 ID 为别名；`black-forest-labs/FLUX.1-Krea-dev`、`MusePublic/majicMIX_realistic`、`MusePublic/14_ckpt_SD_XL`）。它们共用魔搭 API-Inference 的同一套端点与参数，差异只有 model ID、尺寸上限和魔粒档位，因此不单独建文件，统一记在 [供应商/魔搭.md](供应商/魔搭.md) 第 7 节。
+
+### SDK / Say-It 语音识别（21）
+
+以下 21 个模型均有独立 SDK capability descriptor 与按需执行模块；消费应用仍需显式导入和注册，升级包版本不会自动增加界面入口。火山文件版只接受供应商可访问的公网 URL，Say-It 在没有受管上传/TOS 之前不得把它伪装成本地文件入口。
+
+| 模型 | 模式 | 主协议 | 上限 | 文档 |
+|---|---|---|---|---|
+| `fun-asr-realtime-2026-02-28` | 实时 | WebSocket `run-task` | 时长无限制 | [百炼](Fun-ASR-Realtime-2026-02-28/Fun-ASR-Realtime-2026-02-28_百炼.md) |
+| `fun-asr-realtime` | 实时稳定别名 | WebSocket `run-task` | 时长无限制 | [百炼](Fun-ASR-Realtime/Fun-ASR-Realtime_百炼.md) |
+| `qwen3-asr-flash-realtime-2026-02-10` | 实时 | WebSocket session | 时长无限制 | [百炼](Qwen3-ASR-Flash-Realtime-2026-02-10/Qwen3-ASR-Flash-Realtime-2026-02-10_百炼.md) |
+| `qwen3-asr-flash-realtime` | 实时稳定别名 | WebSocket session | 时长无限制 | [百炼](Qwen3-ASR-Flash-Realtime/Qwen3-ASR-Flash-Realtime_百炼.md) |
+| `fun-asr-flash-2026-06-15` | 短音频 | DashScope HTTP/SSE 同步 | 5 分钟 / 2 GB | [百炼](Fun-ASR-Flash-2026-06-15/Fun-ASR-Flash-2026-06-15_百炼.md) |
+| `qwen3-asr-flash` | 短音频稳定别名 | OpenAI 兼容 / DashScope 同步 | 5 分钟 / 10 MB | [百炼](Qwen3-ASR-Flash/Qwen3-ASR-Flash_百炼.md) |
+| `qwen3-asr-flash-2026-02-10` | 短音频快照 | OpenAI 兼容 / DashScope 同步 | 5 分钟 / 10 MB | [百炼](Qwen3-ASR-Flash-2026-02-10/Qwen3-ASR-Flash-2026-02-10_百炼.md) |
+| `fun-asr` | 文件异步 | 提交 + 轮询 + 结果 JSON | 12 小时 / 2 GB | [百炼](Fun-ASR/Fun-ASR_百炼.md) |
+| `qwen3-asr-flash-filetrans` | 文件异步 | 提交 + 轮询 | 12 小时 / 2 GB | [百炼](Qwen3-ASR-Flash-Filetrans/Qwen3-ASR-Flash-Filetrans_百炼.md) |
+| `qwen-audio-3.1-asr-flash` / `qwen-audio-3.0-asr-flash` | 短音频 | Qwen-Audio-ASR HTTP（短于 1 分钟返回 JSON，否则 SSE） | 5 分钟 / 2 GB（内联 7.5 MB） | [百炼](供应商/百炼.md#2026-11-07-qwen-audio-30-asr与新模型盘点) |
+| `qwen-audio-3.1-asr-flash-filetrans` / `qwen-audio-3.0-asr-flash-filetrans` | 文件异步 | 提交 + 轮询 | 12 小时 / 2 GB | [百炼](供应商/百炼.md#2026-11-07-qwen-audio-30-asr与新模型盘点) |
+| `qwen-audio-3.1-asr-flash-streaming` / `qwen-audio-3.0-asr-flash-streaming` | 实时 | WebSocket `run-task`（duplex） | 时长无限制 | [百炼](供应商/百炼.md#2026-11-07-qwen-audio-30-asr与新模型盘点) |
+| `seedasr-2.0-realtime` | 实时 | 火山二进制 WebSocket | PCM S16LE / 16kHz / mono | [火山引擎](SeedASR-2.0-Realtime/SeedASR-2.0-Realtime_火山引擎.md) |
+| `seedasr-2.0-file` | 文件异步 | HTTP submit + query | 仅公网 URL；本地文件需外部 TOS/受管上传 | [火山引擎](SeedASR-2.0-File/SeedASR-2.0-File_火山引擎.md) |
+| `FunAudioLLM/SenseVoiceSmall` | 文件同步 | multipart HTTP | 1 小时 / 50 MB | [硅基流动](SenseVoiceSmall/SenseVoiceSmall_硅基流动.md) |
+| `whisper-large-v3-turbo` | 文件同步 | OpenAI-compatible multipart | 免费层 25 MB；Developer 100 MB | [Groq](Whisper-Large-v3-Turbo/Whisper-Large-v3-Turbo_Groq.md) |
+| `whisper-large-v3` | 文件同步 | OpenAI-compatible multipart | 免费层 25 MB；Developer 100 MB | [Groq](Whisper-Large-v3/Whisper-Large-v3_Groq.md) |
+
+### Say-It 翻译（3）
+
+| 模型 | 流式语义 | 北京原价（输入/输出，每百万 Token） | 文档 |
+|---|---|---|---|
+| `qwen-mt-flash` | 增量 | 0.7 / 1.95 元 | [百炼](Qwen-MT-Flash/Qwen-MT-Flash_百炼.md) |
+| `qwen-mt-plus` | 累积序列 | 1.8 / 5.4 元 | [百炼](Qwen-MT-Plus/Qwen-MT-Plus_百炼.md) |
+| `qwen-mt-lite` | 增量 | 0.6 / 1.6 元 | [百炼](Qwen-MT-Lite/Qwen-MT-Lite_百炼.md) |
+
+### SDK LLM（2）
+
+| 模型 | 供应商 | 备注 | 文档 |
+|---|---|---|---|
+| `openai/gpt-oss-20b` | Groq | Say-It 默认；`reasoning_effort=low/medium/high`；不支持 `reasoning_format` | [Groq](GPT-OSS-20B/GPT-OSS-20B_Groq.md) |
+| `glm-5.3-flash` | 智谱 | 原生多模态 Chat 模型；1M 上下文 / 128K 输出；完整能力仍有官方冲突项 | [智谱](GLM-5.3-Flash/GLM-5.3-Flash_智谱.md) |
+
+## 四、平台模型 ID 速查
+
+### 可选工具模型
+
+| 工具 | Fal endpoint ID | SDK 入口 |
+|---|---|---|
+| Flux Pro Erase | `fal-ai/flux-pro/v1/erase` | `tool-models/fal/flux-pro-erase` |
+| Bria Eraser | `fal-ai/bria/eraser` | `tool-models/fal/bria-eraser` |
+| Finegrain Eraser (Mask) | `fal-ai/finegrain-eraser/mask` | `tool-models/fal/finegrain-eraser` |
+| Qwen Image Edit 2511 多角度 | `fal-ai/qwen-image-edit-2511-multiple-angles` | `@henjicc/ai-sdk/tool-models/fal/qwen-image-edit-2511-multiple-angles` |
+| 透视变换 | `fal-ai/image-apps-v2/perspective` | `@henjicc/ai-sdk/tool-models/fal/perspective-change` |
+| Image Apps v2 重打光 | `fal-ai/image-apps-v2/relighting` | `tool-models/fal/relighting` |
+| ControlLight | `fal-ai/control-light` | `tool-models/fal/control-light` |
+| Image Apps v2 扩图 | `fal-ai/image-apps-v2/outpaint` | `tool-models/fal/outpaint` |
+| Image Apps v2 商品摄影 | `fal-ai/image-apps-v2/product-photography` | `tool-models/fal/product-photography` |
+| Image Apps v2 照片修复 | `fal-ai/image-apps-v2/photo-restoration` | `tool-models/fal/photo-restoration` |
+| Pixelcut 背景移除 | `pixelcut/background-removal` | `tool-models/fal/pixelcut-background-removal` |
+| FLUX 2 多角度 | `fal-ai/flux-2-lora-gallery/multiple-angles` | `tool-models/fal/flux-2-multiple-angles` |
+
+- 3 个消除工具聚合为 `@henjicc/ai-sdk/tool-packs/fal-image-edit-tools`，统一能力画像为 `operation=image-edit`、`feature=erase`。
+- 6 个重打光/修复/扩图/商品/抠图工具聚合为 `@henjicc/ai-sdk/tool-packs/fal-image-utility-tools`，再按单模型画像区分具体能力。
+- Qwen 2509、透视变换和 FLUX 2 聚合为 `@henjicc/ai-sdk/tool-packs/fal-multi-angle-tools`，与消除和实用工具 pack 分开分发。
+
+三个 pack 都只是静态分发集合，执行继续走同一生成客户端和 Fal 公共协议。
+
+| 模型 | APIMart | KIE | Fal |
+|---|---|---|---|
+| Seedream 5.0 Pro | `seedream-5-0-pro` | `seedream/5-pro-text-to-image`、`5-pro-image-to-image`、`5-pro-layer-decomposition` | `bytedance/seedream/v5/pro/{text-to-image,edit}` |
+| Seedream 5.0 Lite | `seedream-5-0-lite` | `seedream/5-lite-text-to-image`、`5-lite-image-to-image` | `bytedance/seedream/v5/lite/{text-to-image,edit}` |
+| Qwen Image 3.0 | `qwen-image-3.0`、`qwen-image-3.0-pro` | `qwen3/{text-to-image,image-to-image}`、`qwen3-pro/text-to-image`、`qwen3/pro-image-to-image` | `alibaba/qwen-image-3/{text-to-image,edit}` |
+| Z-Image Turbo | `z-image-turbo` | `z-image` | `fal-ai/z-image/turbo`、`fal-ai/z-image/turbo/image-to-image`；魔搭 `Tongyi-MAI/Z-Image-Turbo` |
+| GPT-Image-2 | `gpt-image-2`（别名 `gpt-image-2-ext`）、`gpt-image-2-official` | `gpt-image-2-text-to-image`、`gpt-image-2-image-to-image` | `openai/gpt-image-2`、`openai/gpt-image-2/edit` |
+| IC-Light v2 | — | — | `fal-ai/iclight-v2` |
+| Topaz 图片放大 | — | — | `topaz/upscale/image/{precision,creative,generative}` |
+| Topaz 透明图放大 | — | — | `topaz/upscale/image/transparent` |
+| SeedVR2 图片放大 | — | — | `fal-ai/seedvr/upscale/image` |
+| Bria 创意放大 | — | — | `bria/upscale/creative` |
+| Ideogram 图片放大 | — | — | `fal-ai/ideogram/upscale` |
+| Nano Banana 2 | `gemini-3.1-flash-image-preview`(-official) | `nano-banana-2` | `fal-ai/nano-banana-2`、`fal-ai/nano-banana-2/edit` |
+| Nano Banana 2 Lite | `gemini-3.1-flash-lite-image`(-ext) | `nano-banana-2-lite` | ❌ 无（已探测确认） |
+| Nano Banana Pro | `gemini-3-pro-image-preview`(-official) | `nano-banana-pro` | `fal-ai/nano-banana-pro`、`fal-ai/nano-banana-pro/edit` |
+| Midjourney | `midjourney`（Imagine）、`midjourney-blend`、`midjourney-edit`、`midjourney-video`（新路由均自动注入平台模型 ID） | — | — |
+| Grok Imagine 2.0 | `grok-imagine-2.0-ext`、`grok-imagine-image-2.0` | `grok-imagine-image-2-0/{text-to-image,image-edit,segment-map,segment-edit}` | `xai/grok-imagine-image/v2.0/{text-to-image,edit}` |
+| Grok Imagine | — | `grok-imagine/{text-to-image,image-to-image}` | — |
+| Seedance 2.0 | `seedance-2.0` | `bytedance/seedance-2` | `bytedance/seedance-2.0/{text-to-video,image-to-video,reference-to-video}` |
+| Seedance 2.0 Fast | `seedance-2.0-fast` | `bytedance/seedance-2-fast` | `bytedance/seedance-2.0/fast/...` |
+| Seedance 2.0 Mini | `seedance-2.0-mini` | `bytedance/seedance-2-mini` | `bytedance/seedance-2.0/mini/...` |
+| Seedance 2.5 | `seedance-2.5` | `bytedance/seedance-2-5` | `bytedance/seedance-2.5/...` |
+| MiniMax H3 | `MiniMax-H3`、`MiniMax-H3-Context-IR`、`MiniMax-H3-Regeneration` | `minimax-h3/{text-to-video,image-to-video,reference-to-video}` | `minimax/h3/{text-to-video,image-to-video,reference-to-video}`；百炼 `MiniMax/MiniMax-H3` |
+| MiniMax Hailuo 2.3 | — | `hailuo/2-3-image-to-video-{standard,pro}` | `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` |
+| MiniMax Hailuo 02 | — | `hailuo/02-{text,image}-to-video-{standard,pro}` | `fal-ai/minimax/hailuo-02/{standard,pro}/{text-to-video,image-to-video}`、`fal-ai/minimax/hailuo-02-fast/image-to-video` |
+| Kling 3.0 | `kling-v3` | `kling-3.0/video` | `fal-ai/kling-video/v3/{pro,standard}/...`；派欧云 `/v3/async/kling-v3.0-{std,pro,4k}-{t2v,i2v}` |
+| Kling 3.0 Turbo | `kling-3.0-turbo` | `kling/v3-turbo-{text,image}-to-video` | `fal-ai/kling-video/v3/turbo/{pro,standard}/...` |
+| Kling 3.0 Omni | `kling-v3-omni` | `kling-3.0-omni/{text-to-video,image-to-video,reference-to-video,transformation}` | `fal-ai/kling-video/o3/{pro,standard}/...` |
+| Gemini Omni Flash | `gemini-omni-flash-preview`、`Omni-Flash-Ext` | `gemini-omni-video` + `/api/v1/omni/audio/create` + `/api/v1/omni/character/create` | `google/gemini-omni-flash/{image-to-video,reference-to-video}` |
+
+Grsai 的平台模型 ID 未并入本表：它把「渠道」直接编码进 `model` 字段（如 `nano-banana-2-cl`、`gpt-image-2-vip`），渠道数量比 APIMart/KIE/Fal 常见的 2 档更多（GPT-Image-2 2 个、Nano Banana 2 主模型 4 个、Nano Banana 2 Lite 1 个、Nano Banana Pro 5 个），完整枚举见对应模型文档：[GPT-Image-2_Grsai.md](GPT-Image-2/GPT-Image-2_Grsai.md)、[Nano-Banana-2_Grsai.md](Nano-Banana-2/Nano-Banana-2_Grsai.md)、[Nano-Banana-2-Lite_Grsai.md](Nano-Banana-2-Lite/Nano-Banana-2-Lite_Grsai.md)、[Nano-Banana-Pro_Grsai.md](Nano-Banana-Pro/Nano-Banana-Pro_Grsai.md)。
+
+## 五、供应商通用协议速查
+
+| 供应商 | Base URL | 鉴权 | 提交 | 查询 | 结果字段 |
+|---|---|---|---|---|---|
+| **火山引擎** | 方舟 `https://ark.cn-beijing.volces.com`；语音 `https://openspeech.bytedance.com` | 方舟 Bearer；语音 `X-Api-Key` + Resource/Request ID | 图片同步；SeedASR 实时 WSS；文件 `POST /api/v3/auc/bigmodel/submit` | 文件 `POST /api/v3/auc/bigmodel/query` | 图片 `data[]`；ASR `result.text/utterances[]` |
+| **百炼** | `https://{WorkspaceId}.<region>.maas.aliyuncs.com` | `Authorization: Bearer sk-xxxx` | 生成/短 ASR/Qwen-MT 为同步 HTTP；实时 ASR 为 `/api-ws/v1/inference` 或 `/api-ws/v1/realtime` WSS；文件 ASR 为 `POST /api/v1/services/audio/asr/transcription` + `X-DashScope-Async: enable` | 异步 `GET /api/v1/tasks/{task_id}` | 按能力分为图像 `content[].image`、转写事件/文本、`transcription_url`、翻译 `choices[].message.content` |
+| **Groq** | `https://api.groq.com/openai/v1` | `Authorization: Bearer <GROQ_API_KEY>` | `POST /chat/completions`（同步/SSE）；`POST /audio/transcriptions`；`GET /models` | — | Chat choices/delta；ASR `text/language/duration/segments/words` |
+| **硅基流动** | `https://api.siliconflow.cn/v1` | `Authorization: Bearer <API Key>` | `POST /audio/transcriptions` multipart | — | `text`；响应头 `x-siliconcloud-trace-id` |
+| **智谱** | 国内 `https://open.bigmodel.cn/api/paas/v4`；国际 `https://api.z.ai/api/paas/v4` | `Authorization: Bearer <API Key>`；两区凭据分离 | `POST /chat/completions`（同步/SSE） | — | `choices[].message.content/reasoning_content/tool_calls`；流式 `choices[].delta` |
+| **APIMart** | `https://api.apimart.ai`；大陆备用线路见[基础文档](供应商/APIMart.md) | `Authorization: Bearer <KEY>` | `POST /v1/images/generations`、`POST /v1/videos/generations` | `GET /v1/tasks/{task_id}` | `result.images[]` / `result.videos[]` |
+| **KIE** | `https://api.kie.ai` | `Authorization: Bearer <KEY>` | `POST /api/v1/jobs/createTask` | `GET /api/v1/jobs/recordInfo?taskId=` | `JSON.parse(resultJson).resultUrls` |
+| **Fal** | `https://fal.run` / `https://queue.fal.run` | `Authorization: Key $FAL_KEY` | `POST https://queue.fal.run/<endpoint-id>` | `GET .../requests/{id}/status`、`GET .../requests/{id}` | `images[]` / `video` |
+| **派欧云** | `https://api.ppio.com/v3`（代码仍用旧域名 `api.ppinfra.com`，待核实） | `Authorization: Bearer <KEY>` | `POST /v3/async/<route>` | `GET /v3/async/task-result?task_id=` | `images[].image_url` / `videos[].video_url` / `audios[].audio_url`（TTL 3600s） |
+| **魔搭** | `https://api-inference.modelscope.cn` | `Authorization: Bearer <TOKEN>` | `POST /v1/images/generations` + 头 `X-ModelScope-Async-Mode: true`（代码写的是 `/api/v1/jobs/createTask`，待核实） | `GET /v1/tasks/{task_id}` + 头 `X-ModelScope-Task-Type: image_generation` | `output_images[]` |
+| **Grsai** | `https://grsaiapi.com`（全球）/ `https://grsai.dakka.com.cn`（国内直连，已接入连通性探测+自动切换） | `Authorization: Bearer <API Key>` | `POST /v1/api/generate`（`replyType` 项目侧统一强制 `async`） | `GET /v1/api/result?id=` | `results[].url` |
+
+任务状态枚举：
+- APIMart：`pending` / `processing` / `completed` / `failed` / `cancelled`（Midjourney 另有 MJ 风格状态 `NOT_START` / `SUBMITTED` / `IN_PROGRESS` / `MODAL` / `SUCCESS` / `FAILURE`）
+- KIE：`waiting` / `queuing` / `generating` / `success` / `fail`
+- Fal：`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`
+- 百炼异步：`PENDING` / `RUNNING` / `SUCCEEDED` / `FAILED` / `CANCELED` / `UNKNOWN`
+- 火山文件 ASR：响应头 `20000002` 排队 / `20000001` 处理中 / `20000000` 成功；`20000003` 静音终态；`45/55*` 失败
+- 派欧云：`TASK_STATUS_QUEUED` / `TASK_STATUS_PROCESSING` / `TASK_STATUS_SUCCEED` / `TASK_STATUS_FAILED`
+- 魔搭：`SUCCEED` / `FAILED`
+- Grsai：`running` / `violation`（违规，独立终态）/ `succeeded` / `failed`
+
+## 六、常用外部入口
+
+| 用途 | 链接 | 是否需登录 |
+|---|---|---|
+| APIMart 文档总索引 | https://docs.apimart.ai/llms.txt | 否 |
+| APIMart 定价中心 | https://apimart.ai/zh/pricing | 否 |
+| KIE 文档总索引 | https://docs.kie.ai/llms.txt | 否 |
+| KIE 定价页 | https://kie.ai/pricing | 否 |
+| Fal 平台总览 | https://fal.ai/llms.txt | 否 |
+| Fal 单模型 schema | `https://fal.ai/models/<endpoint-id>/llms.txt` | 否 |
+| 火山方舟图片生成 API | https://www.volcengine.com/docs/82379/1541523 | 否 |
+| 火山方舟模型价格 | https://www.volcengine.com/docs/82379/1544106 | 否 |
+| 火山 SeedASR 实时 WebSocket | https://docs.volcengine.com/docs/6561/2630027?lang=zh | 否 |
+| 火山 SeedASR 文件 submit/query | https://docs.volcengine.com/docs/6561/1354868?lang=zh | 否 |
+| 火山 SeedASR 价格/免费额度 | https://docs.volcengine.com/docs/6561/1359369?lang=zh | 否 |
+| 百炼模型价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
+| 百炼 ASR 模型与音频规格 | https://help.aliyun.com/zh/model-studio/asr-model/ | 否 |
+| 百炼 Qwen-MT API | https://help.aliyun.com/zh/model-studio/qwen-mt-api | 否 |
+| Groq 模型/价格 | https://console.groq.com/docs/models | 否 |
+| Groq API 参考 | https://console.groq.com/docs/api-reference | 否 |
+| Groq Reasoning | https://console.groq.com/docs/reasoning | 否 |
+| Groq Speech-to-Text | https://console.groq.com/docs/speech-to-text | 否 |
+| 硅基流动音频转写 API | https://api-docs.siliconflow.cn/docs/api/audio-transcriptions-post | 否 |
+| 硅基流动价格 | https://siliconflow.cn/pricing | 否 |
+| 可灵官方视频能力地图（仅参考） | https://www.klingai.com/document-api/guides/capability-map/video | 否 |
+| 派欧云文档索引 | https://ppio.com/docs/llms.txt | 否 |
+| 派欧云定价页 | https://ppio.com/pricing | 否 |
+| 魔搭 API-Inference 文档 | https://www.modelscope.cn/docs/model-service/API-Inference/intro | 否 |
+| 魔搭魔粒说明 | https://www.modelscope.cn/docs/magicube/intro | 否 |
+| APIMart API Key | https://apimart.ai/keys | **是** |
+| KIE API Key | https://kie.ai/api-key | **是** |
+| Fal API Key | https://fal.ai/dashboard/keys | **是** |
+| 火山方舟 API Key | https://console.volcengine.com/ark/region:cn-beijing/apiKey | **是** |
+| 百炼 API Key | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |
+| Groq API Key | https://console.groq.com/keys | **是** |
+| 硅基流动 API Key | https://cloud.siliconflow.cn/account/ak | **是** |
+| 智谱 GLM-5.3-Flash 模型/API | https://docs.bigmodel.cn/cn/guide/models/vlm/glm-5.3-flash | 否 |
+| 智谱模型价格 | https://open.bigmodel.cn/pricing | 否 |
+| 国际 Z.AI GLM-5.3-Flash | https://docs.z.ai/guides/vlm/glm-5.3-flash | 否 |
+| 国际 Z.AI 模型价格 | https://docs.z.ai/guides/overview/pricing | 否 |
+| Grsai 文档总索引（llms.txt） | https://qmy27nhsd9.apifox.cn/llms.txt | 否 |
+| Grsai dashboard 模型列表（权威价格） | https://grsai.com/zh/dashboard/models | 否 |
+| Grsai dashboard 公告（渠道调价历史） | https://grsai.com/zh/dashboard/announcements | 否 |
+| Grsai API Key | https://grsai.ai/zh/dashboard/api-keys | **是** |
+
+## 七、维护方式
+
+- **动手前**：先读 [文档采集手册.md](文档采集手册.md)——官方来源、流式事件矩阵、fixture/parser 测试闭环和 SDK 首发顺序的详细门槛只维护在这里
+- **新增模型**：在本文件的清单表里加一行 → 建同名文件夹 → 为每个支持它的供应商写一份 `<模型名>_<供应商名>.md`
+- **更新已有模型**：直接改对应的供应商文件，并更新该文件头部的「最后更新」以及本文件的「最后更新」
+- **信息来源要求**：每条参数 / 价格都要能追溯到文件末尾「原始链接索引」中的某个链接；需要登录才能看到的页面必须标注
+
+## 2026-10-12 Nano Banana 2.1
+
+[APIMart](Nano-Banana-2.1/Nano-Banana-2.1_APIMart.md) · [KIE](Nano-Banana-2.1/Nano-Banana-2.1_KIE.md) · [Fal](Nano-Banana-2.1/Nano-Banana-2.1_Fal.md) · [Grsai](Nano-Banana-2.1/Nano-Banana-2.1_Grsai.md)