Skip to Content
模板使用模板使用

模板使用

配图占位：本节用于在后续视觉评审中插入「模板推荐」面板截图（首页左栏下半：3 张推荐模板卡片骨架 + 模板市场快捷入口）。

用途

模板是一组预先配置好的项目参数：画面比例、画风、时长、字幕样式等。把它当作「项目配方」——选择后系统会复制这套参数到新项目，让你跳过重复设置。

主要场景：

  • 首页发现模板：在 /home 左栏下方「推荐模板」面板找到感兴趣的系统推荐卡片。
  • 快速访问模板：通过首页「快速访问」面板中的「模板市场」入口进入。
  • 使用模板创建项目：点击模板卡片，跳转到 /workspace 并自动带入 templateId，确认参数后开始创作。
  • 多语言展示：模板名称与描述按界面语言显示，/api/templates 接受 ?locale=zh|en 参数。

使用前准备

  • 账号已登录 /home，否则会跳转到登录页。
  • 推荐模板面板需要 /api/templates?recommended=true&limit=3 可用；若不可用会自动降级为占位文案。
  • 「使用模板」入口在 /api/templates 落地前保持 disabled 状态，避免点击进入空白页。

操作步骤

  1. 登录 /home。
  2. 在左栏下方「推荐模板」面板浏览最多 3 张系统推荐卡片。
  3. 点击感兴趣的模板卡片，自动跳转到 /workspace 并带入 templateId。
  4. 在工作区确认参数（画面比例、画风、时长、字幕样式等）后开始创作。
  5. 通过首页「快速访问 → 模板市场」入口可查看更多模板。

结果与状态

  • 推荐位加载成功：面板显示最多 3 张系统推荐卡片，按 usageCount 倒序。
  • 推荐位加载失败：面板降级为占位文案（玻璃外壳保留），不影响其他面板渲染。
  • 使用模板创建项目：模板参数自动带入新项目，跳过重复设置步骤。
  • 多语言切换：模板名称与描述按界面语言显示，未传 locale 参数时按系统语言展示。
  • 「模板市场」入口 disabled：在 /api/templates 落地前保持 disabled 状态。

权限和边界

  • 必须登录后才能访问 /home 和使用模板入口；未登录跳转到登录页。
  • 系统（system）模板由管理员在 /admin/templates 维护；用户（user）模板只读。
  • 推荐位由后端按 usageCount 倒序返回启用中的 system 模板；管理员调整排序与启用状态会直接影响推荐结果。
  • 「模板加载失败」时面板降级为占位文案，不会触发第二次模型调用或其他重试。
  • 模板参数（画面比例、画风、时长、字幕样式）只在新项目创建时带入；修改后不会自动重写已生成素材。

常见问题

  • Q：为什么「推荐模板」面板显示占位骨架？ A：后端 /api/templates 尚未实现（详见 backlogs §BG-002）。面板降级为占位文案，保留玻璃外壳。模板 API 落地后会自动启用。
  • Q：点击模板卡片后跳转到哪里？ A：跳转到 /workspace 并自动带入 templateId；工作区加载模板参数后即可开始创作。
  • Q：模板加载失败会触发重试吗？ A：不会。面板降级为占位文案，不会影响其他面板渲染，也不会触发第二次模型调用。
  • Q：切换语言后模板名称没变？ A：/api/templates 接收 ?locale=zh|en 参数；不传时按系统语言展示。管理员可在 /admin/templates 维护中英文文案。

相关文档

Last updated on
API 耗时统计AIGC 中央 chat 工作台