72 lines
3.2 KiB
Markdown
72 lines
3.2 KiB
Markdown
# Change: 调整 Kling 视频能力路由为“能力模型 + 执行版本”
|
||
|
||
## Why
|
||
|
||
当前 Kling 标准视频链路和 Suno 已经采用的“能力入口 / 执行版本”模式不一致：
|
||
|
||
- 运行时发现更接近能力标识，例如 `kling_video`
|
||
- 实际提交接口要求通过请求体 `model_name` 传入执行版本
|
||
- Kling 标准视频仍需要按 action 建模版本合法性，即使当前 `text2video` 与 `image2video` 已共享同一组主版本
|
||
- 当前实现仍主要把 `kling-v1-6` 这类版本字符串当作直接调用模型，导致发现层、路由层和执行层的语义混在一起
|
||
|
||
这会带来几个具体问题：
|
||
|
||
- 发现到 `kling_video` 时，运行时无法稳定映射到正确的执行版本
|
||
- `text2video` 与 `image2video` 的版本约束只能散落在 adapter 条件分支中
|
||
- 老的版本型模型 ID 与新的能力型模型 ID 并存时，默认路由和参数表单容易失真
|
||
- `kling-video-o1`、`kling-video-o1-edit` 这类特例模型与标准 Kling 视频能力共用识别规则，后续扩展风险高
|
||
|
||
## What Changes
|
||
|
||
- 将标准 Kling 视频能力明确建模为能力模型 `kling_video`
|
||
- 将真正执行版本明确建模为请求字段 `model_name`
|
||
- 为标准 Kling 视频 binding 增加版本字段元数据，包括：
|
||
- `versionField`
|
||
- `defaultVersion`
|
||
- `versionOptions`
|
||
- `versionOptionsByAction`
|
||
- 保留 `text2video / image2video` 的 action 分流，但把版本合法性和默认值绑定到 action
|
||
- 保持对历史版本型模型 ID 的兼容，例如：
|
||
- `kling-v1-5`
|
||
- `kling-v1-6`
|
||
- 显式将 `kling-video-o1` 与 `kling-video-o1-edit` 排除在标准 Kling 视频能力路由之外
|
||
|
||
## Scope
|
||
|
||
### In Scope
|
||
|
||
- 标准 Kling 视频能力 `kling_video` 的路由与执行建模
|
||
- `model_name` 版本参数的运行时解析与默认值策略
|
||
- `text2video` 与 `image2video` 的版本约束建模
|
||
- 旧版本型模型 ID 到新能力型路由的兼容策略
|
||
- 最小必要的参数暴露，用于选择标准 Kling 执行版本
|
||
|
||
### Out Of Scope
|
||
|
||
- 本次不接入 `kling_effects`
|
||
- 本次不接入 `kling_extend`
|
||
- 本次不接入 `kling_lip_sync`
|
||
- 本次不接入 `kling_virtual_try_on`
|
||
- 本次不将 `kling-video-o1` 与 `kling-video-o1-edit` 迁入这套标准 Kling 视频能力模型
|
||
- 本次不一次性为 Kling 全量高级字段设计完整可视化表单，例如复杂 `camera_control` 编辑器
|
||
|
||
## Impact
|
||
|
||
- Affected specs:
|
||
- `provider-protocol-routing`
|
||
- Affected code:
|
||
- `packages/drawnix/src/services/provider-routing/*`
|
||
- `packages/drawnix/src/services/model-adapters/kling-adapter.ts`
|
||
- `packages/drawnix/src/services/model-adapters/registry.ts`
|
||
- `packages/drawnix/src/services/video-binding-utils.ts`
|
||
- `packages/drawnix/src/constants/model-config.ts`
|
||
- `packages/drawnix/src/constants/video-model-config.ts`
|
||
- `packages/drawnix/src/components/ttd-dialog/ai-video-generation.tsx`
|
||
- `packages/drawnix/src/components/ai-input-bar/*`
|
||
|
||
## Relationship To Existing Changes
|
||
|
||
- 本变更建立在 `add-provider-protocol-routing` 的协议绑定架构之上
|
||
- 本变更复用 `add-audio-generation-suno-routing` 已采用的“能力标识不等于执行版本”设计原则
|
||
- 本变更不改变标准 Kling 接口的 submit / poll URL，而是调整运行时如何解释能力模型与版本字段
|