用途
VEED Fabric 技能用于在对话中生成带 AI 数字人的专业口播视频(talking head videos)。用户无需相机或剪辑技能,即可通过对话完成视频创建。该技能本身是一份操作指南,需配合 VEED Fabric MCP 服务器使用,服务器提供下文引用的全部工具。
前置条件
使用该技能需要先连接 VEED Fabric MCP 服务器。资料中列出了平台特定的设置入口:Claude、ChatGPT、Goose。
推荐工作流
为获得最佳用户体验,建议按以下顺序操作:
- 浏览角色——调用 list_characters 显示头像轮播,让用户挑选。
- 浏览声音——调用 list_voices 并传入合适的 locale,让用户挑选。
- 询问脚本——如果用户尚未提供,询问数字人应该说什么。
- 生成前确认——调用 confirm_fabric_video 显示费用估算和参数,等待用户确认。
- 生成视频——仅在确认后调用 create_fabric_video。
- 检查进度——用返回的 job ID 调用 get_generation_status。视频通常需要 1–2 分钟。
应始终让用户交互式地做出选择,而不是替他们选择默认值。
工具使用指南
list_characters
- 返回带缩略图的 AI 数字人角色。
- 可选性别筛选:"male" 或 "female"。
- 显示交互式轮播组件,让用户可视化浏览。
- 当用户说“show me characters”时调用此工具。
list_voices
- 需要 locale 参数(例如 "en"、"fr"、"es"、"en-GB")。
- 可选性别筛选:"Female"、"Male" 或 "Neutral"。
- 显示带音频预览的声音选择组件。
- 根据用户脚本语言推断 locale,不明确时询问。
- 当用户提供特定语言的脚本时,将声音筛选为该语言。
confirm_fabric_video
- 在 create_fabric_video 之前必须始终调用。
- 显示确认对话框,包含:脚本文本、所选角色、所选声音、积分费用估算。
- 需要 script、voiceId 和 characterId。
- 可选:aspectRatio("landscape"、"portrait"、"square",默认 landscape)。
- 可选:workspaceId(用户只有一个工作区时自动选择)。
- 不要跳过此步骤——用户应始终在生成前看到费用。
create_fabric_video
- 生成实际视频——消耗积分。
- 参数与 confirm_fabric_video 相同。
- 仅在用户通过 confirm_fabric_video 确认后调用。
- 返回用于跟踪进度的 jobId。
get_generation_status
- 用 create_fabric_video 返回的 jobId 轮询。
- 状态值:queued → processing → completed 或 error。
- 完成后显示内嵌视频播放器。
- 如果用户问“is my video ready?”,调用此工具。
get_credit_balance
- 显示可用与总 AI Playground 积分。
- 可选 workspaceId 参数。
- 当用户询问积分或制作长视频前有用。
list_workspaces
- 列出用户可访问的工作区。
- 无需参数。
- 仅在用户有多个工作区并想选择时使用。
UI 组件
VEED Fabric 提供丰富的交互式组件,在调用工具时自动显示:
- 角色轮播——可视化浏览头像(来自 list_characters)。
- 声音选择——带音频预览的声音列表(来自 list_voices)。
- 视频确认——费用明细和确认按钮(来自 confirm_fabric_video)。
- 视频结果——进度指示器和视频播放器(来自 get_generation_status)。
这些组件比纯文本提供更好的体验,建议优先调用能触发它们的工具。
常见用户请求
- “Make me a video” / “Create a video about...” → 完整工作流:角色 → 声音 → 确认 → 创建 → 状态。
- “Show me characters” / “What avatars are available?” → 调用 list_characters。
- “What voices do you have?” → 询问语言偏好,然后调用 list_voices。
- “How many credits do I have?” → 调用 get_credit_balance。
- “Is my video ready?” / “Check my video” → 用 job ID 调用 get_generation_status。
- “Make a video in French/Spanish/etc.” → 使用相同工作流,但按相应 locale 筛选 list_voices。
错误处理
- 积分不足——如果 confirm_fabric_video 显示用户积分不足,告知用户并建议缩短脚本或检查套餐。
- 生成失败——如果 get_generation_status 返回 error,告知用户并提供重试。
- 该 locale 无声音——如果 list_voices 返回空,建议尝试更宽泛的 locale(例如用 "en" 代替 "en-AU")。
限制
资料未提供该技能的具体收费、价格、平台支持范围、视频时长上限或输出格式等细节,这些信息暂未提供。