# 能力：2.0 与 2.5，以及该承诺什么

两个完全不同的问题经常被混在一起：

1. **模型发布**宣布了什么？
2. **这家服务的 API** 今天真正能接受什么？

下面所有数字在被核实为第二类之前，都按第一类对待。宣布的能力不是 API 契约，而且几条被广泛引用的 2.5 头部能力属于**平台功能**而非 API 参数。

## 参考素材上限

| 类型 | 2.0 | 2.5 |
|---|---|---|
| 每次请求图片数 | 0–9 | 最多 30 |
| 参考视频 | 最多 3 条，单条 2–15s，合计 ≤15s | 最多 10 条，单条 2–30s，合计 ≤30s |
| 参考音频 | 最多 3 条，单条 2–15s，合计 ≤15s | 最多 10 条，单条 2–30s，合计 ≤30s |
| 仅传音频 | 不支持——至少需要一张图或一条视频 | 支持 |
| 合计上限 | — | 约 50 份素材 |

实际的单条边界比标称值略宽（低端约 1.8s，高端略超标称上限），因为输出会比请求时长略长一点。

## 时长

| | 2.0 | 2.5 |
|---|---|---|
| 范围 | 4–15s | 4–30s |

## 分辨率

2.0 提供 480p 与 720p。**2.5 请读所在服务的模型页**——发布材料描述了比 2.0 更高的输出，但枚举值各家不同，而且只有枚举值值得引用。不要把发布材料里的分辨率当成 API 参数复述。

## 稳定范围

推荐范围关乎稳定性，不是硬上限。超出是允许的，只是可预测性下降——预期要多重跑几次。

| 输入 | 稳定 | 可行但不稳 |
|---|---|---|
| 主体图里的不同主体 | 1–8 个 | 9–12 个 |
| 主体音／视频里的不同主体 | 1–5 个 | 6–10 个 |
| 每个主体的参考片时长 | 5–10s | 更长 |
| 编辑用的源视频 | 20 秒以内 | 更长 |
| 视频编辑的参考图 | 1–5 张 | 6–8 张 |

**视角**：约五个主体以内，单视角与多视角都行。超过之后优先单视角。需要多个视角时，一个视角一张图比拼成一张更稳。

## 会被自动锁定的参数

有些任务类型从输入推导参数，不允许你设定：

| 任务 | 画幅 | 时长 |
|---|---|---|
| 视频编辑 | 继承源片，不能单独设 | 约等于源片，不能单独设。帧处理可能带来最多约 0.3 秒差异 |
| 首帧、或首尾帧 | 继承**第一张**图 | 可以设 |
| 视频延长 | 继承源片 | 延长长度可以设 |

首尾帧的两张图要用**相同画幅**——画幅不一致会拉伸尾帧。

## 平台功能与 API 参数

以下内容出现在 2.5 的发布与产品文档里。它们是**第一方创作平台的功能**。任何一项能否通过某个 API 触达，完全取决于那家服务，而且其中几项本质上是 UI 驱动的：

| 功能 | 为什么可能不是 API 参数 |
|---|---|
| 远超 30s 的长视频模式一次直出 | 那是一个独立的产品模式，不是时长参数 |
| 嵌套式延长叠加超过单次请求上限 | 一个迭代式的 UI 流程 |
| 标注式编辑（框选、笔刷、锚点） | 需要在画面上做标注输入 |
| DCC 白模插件（Maya、Blender） | 一个独立集成，不是模型参数 |
| 从一组图片一键成片 | 模型之上的产品工作流 |
| 两条成片之间的无缝桥接 | 可能暴露、也可能不暴露 |

**不要把这些当成模型规格引用。** 常见错误是把发布材料里的最大时长当作任何 API 调用都能请求的值。只陈述该服务模型页枚举出来的东西；其余若必须提及，描述为「已宣布的平台能力」。

## 提供某条路线之前

1. 确认该服务真的暴露了这个模型。**200 响应不算确认**——兜底页也返回 200。查页面标题与正文，不是状态码；绝不要从猜测的 org/model slug 推断端点
2. 从那个页面读枚举参数，而不是从文档样例。参数名有时在外部文档与实际页面之间不一致；两者冲突时**以实际页面为准**

   ⚠️ **但页面自己的参数表也可能是错的。** 本平台已确认三次：文档写的范围**比实际能提交的更窄**（H3 t2v 文档写 `5-10`、实测 15s 可用；Kling 两个档位都写 `5 or 10`、实测 15s 均可用）。**直接提交你真正想要的值，让 API 来回答**——被拒不创建任务、不花钱
3. 确认哪些任务类型被暴露。文生视频可用，完全不代表编辑或延长可用
4. 把查到的结果记进 [model-profile.zh-CN.md](model-profile.zh-CN.md)，下次运行不必重新探测

## 任何能力档次都解决不了的事

- 必须准确无误的文字——字幕、公式、招牌、产品规格。做成素材或后期加上
- 帧精确的时序。时间戳分配预算，不是剪辑点
- 编辑或边界处的逐像素保留。编辑大体上保留内容与事件顺序，不是精确保留

## 关联

- [model-profile.zh-CN.md](model-profile.zh-CN.md) · [long-video.zh-CN.md](long-video.zh-CN.md) ·
  [multi-reference.zh-CN.md](multi-reference.zh-CN.md) ·
  [editing-and-extension.zh-CN.md](editing-and-extension.zh-CN.md)