SuperAPI AI Directory

veed-fabric-skill

Agents & models

View repository

Updated 10-16 06:09

About this skill

VEED Fabric Video Creation

VEED Fabric lets users generate professional talking head videos with AI avatars directly from a conversation. No camera or editing skills required.

Prerequisites

This skill requires the VEED Fabric MCP server to be connected. It provides all the tools referenced below. See platform-specific setup:

Recommended Workflow

Follow this sequence for the best user experience:

  1. Browse characters — Call list_characters to show the avatar carousel. Let the user pick.
  2. Browse voices — Call list_voices with the appropriate locale. Let the user pick.
  3. Ask for a script — If the user hasn't already provided one, ask what the avatar should say.
  4. Confirm before generating — Call confirm_fabric_video to show cost estimate and parameters. Wait for user confirmation.
  5. Generate the video — Call create_fabric_video only after confirmation.
  6. Check progress — Call get_generation_status with the returned job ID. Videos typically take 1–2 minutes.

Always let the user make selections interactively rather than choosing defaults for them.

Tool Usage Guide

list_characters

  • Returns AI avatar characters with thumbnails
  • Optional gender filter: "male" or "female"
  • Displays an interactive carousel widget — let users browse visually
  • When the user says "show me characters", call this tool

list_voices

  • Requires locale parameter (e.g., "en", "fr", "es", "en-GB")
  • Optional gender filter: "Female", "Male", or "Neutral"
  • Displays a voice selector widget with audio previews
  • Infer the locale from the user's script language or ask if unclear
  • When the user provides a script in a specific language, filter voices to that language

confirm_fabric_video

  • Always call this before create_fabric_video
  • Shows a confirmation dialog with: script text, selected character, selected voice, credit cost estimate
  • Requires script, voiceId, and characterId
  • Optional: aspectRatio ("landscape", "portrait", "square" — defaults to landscape)
  • Optional: workspaceId (auto-selected if user has only one workspace)
  • Do not skip this step — users should always see the cost before generating

create_fabric_video

  • Generates the actual video — consumes credits
  • Same parameters as confirm_fabric_video
  • Only call after the user has confirmed via confirm_fabric_video
  • Returns a jobId for tracking progress

get_generation_status

  • Poll with the jobId from create_fabric_video
  • Status values: queued → processing → completed or error
  • When complete, displays an inline video player
  • If the user asks "is my video ready?", call this tool

get_credit_balance

  • Shows available vs total AI Playground credits
  • Optional workspaceId parameter
  • Useful when the user asks about credits or before a long video

list_workspaces

  • Lists workspaces the user has access to
  • No parameters required
  • Only needed when the user has multiple workspaces and wants to choose one

UI Widgets

VEED Fabric provides rich interactive widgets that display automatically when tools are called:

  • Characters Carousel — visual browsing of avatars (from list_characters)
  • Voice Selection — voice list with audio previews (from list_voices)
  • Video Confirmation — cost breakdown and confirm button (from confirm_fabric_video)
  • Video Result — progress indicator and video player (from get_generation_status)

These widgets give users a much better experience than plain text. Prefer calling the tools that trigger them.

Common User Requests

User says What to do
"Make me a video" / "Create a video about..." Full workflow: characters → voices → confirm → create → status
"Show me characters" / "What avatars are available?" Call list_characters
"What voices do you have?" Ask for language preference, then call list_voices
"How many credits do I have?" Call get_credit_balance
"Is my video ready?" / "Check my video" Call get_generation_status with the job ID
"Make a video in French/Spanish/etc." Use the same workflow but filter list_voices by the appropriate locale

Error Handling

  • Insufficient credits — If confirm_fabric_video shows the user doesn't have enough credits, inform them and suggest a shorter script or checking their plan.
  • Generation fails — If get_generation_status returns error, let the user know and offer to retry.
  • No voices for locale — If list_voices returns empty, suggest trying a broader locale (e.g., "en" instead of "en-AU").