9.5 KiB
9.5 KiB
火山引擎视频模型配置流程说明
📊 数据流程图
┌─────────────────────────────────────────────────────────────────┐
│ 步骤1：管理员在UI中配置模型 │
├─────────────────────────────────────────────────────────────────┤
│ - 选择"火山引擎视频"Provider │
│ - 看到4个模型配置表单（动态从预设加载） │
│ - 可以修改： │
│ ✏️ 模型ID（例如：doubao-seedance-1-0-pro-250528） │
│ ✏️ 显示名称（例如：豆包 Seedance Pro 250528） │
│ ✏️ 描述（例如：全功能专业版...） │
│ - 点击"保存" │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ 步骤2：API处理并保存到数据库 │
├─────────────────────────────────────────────────────────────────┤
│ API: POST /api/admin/volcano-video-models │
│ │
│ 1️⃣ 接收管理员输入的模型配置 │
│ { modelId, displayName, description } │
│ │
│ 2️⃣ 智能匹配预设配置（从 volcano-video-models.ts） │
│ - 精确匹配：直接使用预设的 capabilities │
│ - 模糊匹配：如果模型ID是新版本，匹配相似配置 │
│ - 兜底方案：使用Pro版本的默认配置 │
│ │
│ 3️⃣ 合并配置并保存到数据库 AiModel 表： │
│ INSERT INTO "AiModel" ( │
│ providerId, -- 火山引擎视频Provider ID │
│ modelId, -- ✅ 管理员输入 │
│ displayName, -- ✅ 管理员输入 │
│ description, -- ✅ 管理员输入 │
│ capabilities, -- 🔧 从预设自动填充 │
│ defaultParams, -- 🔧 从预设自动填充 │
│ supportsVision, -- 🔧 从预设自动填充 │
│ supportsImageGen, -- 🔧 从预设自动填充 │
│ isEnabled, -- ✅ 默认 true │
│ sortOrder -- 🔧 从预设自动填充 │
│ ) │
│ │
│ ✅ 保存成功！数据库现在包含完整的模型配置 │
└─────────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────────┐
│ 步骤3：前端功能从数据库读取模型配置 │
├─────────────────────────────────────────────────────────────────┤
│ 场景1：聊天界面 - 选择模型 │
│ GET /api/models │
│ → 返回所有启用的模型（包含 capabilities） │
│ → 前端显示模型列表供用户选择 │
│ │
│ 场景2：视频生成 - 参数验证 │
│ 用户选择：分辨率 1080p、比例 16:9、时长 8秒 │
│ ↓ │
│ 从数据库读取模型的 capabilities： │
│ { │
│ supportedResolutions: ['480p', '720p', '1080p'], │
│ supportedRatios: ['16:9', '4:3', '1:1', ...], │
│ durationRange: { min: 2, max: 12 } │
│ } │
│ ↓ │
│ ✅ 验证通过：1080p ∈ supportedResolutions │
│ ✅ 验证通过：16:9 ∈ supportedRatios │
│ ✅ 验证通过：8秒 在 [2, 12] 范围内 │
│ ↓ │
│ 调用视频生成API │
│ │
│ 场景3：智能模型选择 │
│ 用户选择"首尾帧过渡"模式 │
│ ↓ │
│ 查询数据库：WHERE capabilities->'supportedModes' @> '["first-last-frame"]' │
│ ↓ │
│ 返回支持该模式的模型列表： │
│ - doubao-seedance-1-0-pro-250528 ✅ │
│ - doubao-seedance-1-0-lite-i2v-250428 ✅ │
│ ↓ │
│ 自动选择优先级最高的模型 │
└─────────────────────────────────────────────────────────────────┘
🔄 模型名称更新场景
场景：火山引擎发布新版本模型
旧模型：doubao-seedance-1-0-pro-250528
新模型：doubao-seedance-1-0-pro-260115 ← 新版本
管理员操作：
- 在系统设置中，打开"添加模型"对话框
- 选择"火山引擎视频"Provider
- 修改第一个模型的
模型ID为doubao-seedance-1-0-pro-260115 - 显示名称自动变为：
豆包 Seedance Pro 260115 - 点击"保存"
系统处理：
// API智能匹配逻辑
const preset = VOLCANO_VIDEO_MODEL_PRESETS.find(p =>
p.modelId === 'doubao-seedance-1-0-pro-260115'
);
// ❌ 找不到精确匹配
// 尝试模糊匹配
const baseModelId = 'doubao-seedance-1-0'; // 提取基础名称
const preset = VOLCANO_VIDEO_MODEL_PRESETS.find(p =>
p.modelId.startsWith(baseModelId)
);
// ✅ 找到：doubao-seedance-1-0-pro-250528
// 使用旧版本的 capabilities 作为模板
return {
...preset, // 继承 capabilities、defaultParams
modelId: 'doubao-seedance-1-0-pro-260115', // 使用新版本ID
displayName: '豆包 Seedance Pro 260115', // 管理员输入
description: '全功能专业版（2025年1月新版）' // 管理员输入
};
// ✅ 保存到数据库，前端功能正常使用
📝 后续维护步骤
当火山引擎更新模型名称时：
方式1：管理员直接在UI中修改（推荐）
- 打开系统设置 → AI 模型
- 找到旧模型，点击"编辑"
- 修改模型ID和显示名称
- 保存即可
方式2：开发者更新预设配置（适用于批量更新）
- 修改
lib/ai/volcano-video-models.ts文件 - 更新
VOLCANO_VIDEO_MODEL_PRESETS数组中的模型配置 - 部署代码
- 管理员在UI中删除旧模型，重新添加（会自动使用新预设）
🎯 关键优势
✅ 灵活性：管理员可以随时更新模型名称，无需代码改动
✅ 智能性：API能自动匹配相似配置，避免配置丢失
✅ 一致性：所有功能都从数据库读取，保证数据统一
✅ 可维护性：预设配置集中管理，易于批量更新
⚠️ 注意事项
- 首次添加模型时，必须选择火山引擎视频Provider，系统才会显示4个模型配置表单
- 模型ID必须唯一，不能重复添加相同的模型
- capabilities字段很重要，决定了视频生成的参数验证逻辑
- 如果预设配置不匹配，系统会使用Pro版本的默认配置作为兜底