SuperAPI AI 工具集

veed-fabric-skill

智能体与模型

查看项目

更新于 10-16 06:09

技能介绍

用途

VEED Fabric 技能用于在对话中生成带 AI 数字人的专业口播视频(talking head videos)。用户无需相机或剪辑技能,即可通过对话完成视频创建。该技能本身是一份操作指南,需配合 VEED Fabric MCP 服务器使用,服务器提供下文引用的全部工具。

前置条件

使用该技能需要先连接 VEED Fabric MCP 服务器。资料中列出了平台特定的设置入口:Claude、ChatGPT、Goose。

推荐工作流

为获得最佳用户体验,建议按以下顺序操作:

  1. 浏览角色——调用 list_characters 显示头像轮播,让用户挑选。
  2. 浏览声音——调用 list_voices 并传入合适的 locale,让用户挑选。
  3. 询问脚本——如果用户尚未提供,询问数字人应该说什么。
  4. 生成前确认——调用 confirm_fabric_video 显示费用估算和参数,等待用户确认。
  5. 生成视频——仅在确认后调用 create_fabric_video。
  6. 检查进度——用返回的 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")。

限制

资料未提供该技能的具体收费、价格、平台支持范围、视频时长上限或输出格式等细节,这些信息暂未提供。