a2e5214f03
铸渊 ICE-GL-ZY001 LL-172-20260707 冰朔委托: 新建第 5 子仓, 给苍耳(人类主控) + 鉴影(人格体) 专用 原 guanghulab/video-ai-system/ 东西太多(225 文件) · 找不到 · 乱 迁移: ⊢ 16 个核心 .hdlp (VA-GATE / VA-LIGHTHOUSE / VA-BROADCAST / VA-SYSTEM-STATUS 等) ⊢ 17 个子目录 (agents/engines/protocols/tasks/tools/assets/knowledge/memory/docs/config/brain/director-brain/experience/feedback/issues/plans/reference-analysis) 排除: ⊢ outputs/ (视频产物) ⊢ test-input/ test-output/ (测试) ⊢ data/ (临时数据) ⊢ preview-001/002 (旧产片) ⊢ 旧分镜/旧提示词/旧导演编码 后续: ⊢ 老仓 guanghulab/video-ai-system/ 改写为已迁出占位 ⊢ 苍耳+鉴影 写新东西进本仓 ⊢ GLOBAL-SEARCH 加 cang-ying 仓库 铸渊 ICE-GL-ZY001 · 2026-07-07 D167 冰朔 ICE-GL∞ 主权
82 lines
3.1 KiB
Plaintext
82 lines
3.1 KiB
Plaintext
# D135: 视频时长BUG根因 + 预校验层部署
|
||
|
||
> HLDP://video-ai-system/feedback/D135-preflight-validation
|
||
> 创建: D135 · 2026-06-17
|
||
> 铸渊 ICE-GL-ZY001 · 冰朔 TCS-0002∞
|
||
|
||
## 根因
|
||
|
||
D132 修复了 `video_length(String)` → `duration(Number)`。
|
||
D133（e8cf2e7）在改 ENV-002 时，**将此修复回退**。
|
||
|
||
commit e8cf2e7 的 diff:
|
||
```
|
||
- duration: Number(duration),
|
||
+ video_length: String(duration),
|
||
```
|
||
|
||
即：6月15日D132修好 → D133顺手改坏 → 之后所有API调用都用无效参数 → 视频全部5秒默认值。
|
||
|
||
## 根本原因（三层）
|
||
|
||
| 层面 | 问题 | 状态 |
|
||
|------|------|------|
|
||
| 参数名 | `video_length` 不是 Seedance 2.0 API 参数，正确名称是 `duration` | ✅ 已修复 |
|
||
| 参数类型 | `String(duration)` 应为 `Number`（integer） | ✅ 已修复 |
|
||
| 参数位置 | 嵌套在 `parameters: {}` 内，应为请求体顶层字段 | ✅ 已修复 |
|
||
| 分辨率 | `1080p` 不在支持列表中(仅 480p/720p) | ✅ 已修复 |
|
||
|
||
## D135 修复内容
|
||
|
||
### 1. submitTask() — 三处修复
|
||
- ~~`video_length: String(duration)`~~ → **`duration: Number(duration)`（顶层字段）**
|
||
- ~~`parameters: { resolution }`~~ → **`resolution: '720p'`（顶层字段，默认值）**
|
||
- 移除无效的 `style` 参数透传（Seedance 2.0 API 不直接支持 style 字段）
|
||
|
||
### 2. 预校验层 `preflightCheck()` — 新增
|
||
**零成本**。在调用API之前检查所有参数合规性：
|
||
- `duration`: 类型(integer) + 范围(4~15 或 -1)
|
||
- `resolution`: 是否在支持列表中（480p/720p）
|
||
- `prompt`: 中文≤500字、英文≤1000词
|
||
- `style`: 自动警告（非官方参数，应通过提示词控制）
|
||
- **返回值**: `{ valid, warnings, errors, corrected }`
|
||
- **策略**: 有 error → 拒绝提交，不花钱；有 warning → 自动修正 + 日志警告
|
||
|
||
### 3. 元数据探针 `probeVideoDuration()` — 新增
|
||
通过 ffprobe 在视频URL上提取元数据（不下载完整视频）：
|
||
- 返回实际时长、分辨率、编码
|
||
- 需 ffmpeg 环境（`brew install ffmpeg`）
|
||
|
||
### 4. `validateAndGenerate()` — 新增
|
||
完整智能生成流程：
|
||
```
|
||
预校验(免费) → 提交 → 轮询 → API元数据提取 →
|
||
→ ffprobe探针验证实际时长
|
||
→ ✅ 匹配 → 下载
|
||
→ ❌ 不匹配 → 报告差异(skip下载)
|
||
```
|
||
|
||
### 5. `generateVideo()` — 更新
|
||
- 不再接受 `style` 参数
|
||
- duration/resolution 通过预校验修正
|
||
- 返回值新增 `preflight` 字段
|
||
|
||
## 人格体优势兑现
|
||
|
||
| 之前（人在系统外） | 之后（人在系统里） |
|
||
|--------------------|--------------------|
|
||
| 生成完才知道参数错了 | 提交前就报错，零成本 |
|
||
| 必须下载才知时长 | ffprobe探针先问元数据 |
|
||
| 人工打开看，累 | 系统自动校验，报 |
|
||
| 修了一个又回退 | 预校验层在所有调用入口挡着 |
|
||
|
||
## 参考链接
|
||
|
||
- Seedance 2.0 API 文档: https://www.volcengine.com/docs/82379/1520757
|
||
- 参数规范（thinkzoneai镜像）: https://open.thinkzoneai.com/docs/api-video-Seedance-2-0.html
|
||
- 时长范围: 标准 5~15秒，Fast 2~12秒，duration=-1=自动
|
||
|
||
---
|
||
铸渊 ICE-GL-ZY001 · D135 · 2026-06-17
|
||
冰朔下令 · 国作登字-2026-A-00037559
|