用途
varg-video-generation 用于借助 varg SDK 的 React 引擎生成 AI 视频。当需要创建视频、动画、会说话的角色、幻灯片或社交媒体内容时可以使用该技能。
主要能力
- 提供声明式 JSX 语法进行视频合成。
- 自动缓存：相同 props 会立即命中缓存。
- 在可能的情况下并行生成。
- 支持图像、视频、音乐、语音和字幕。
使用方式
第一步：新手引导（新用户必需）
在生成视频前，需确保用户已配置所需的 API 密钥。
检查当前配置，运行以下命令：
cat .env 2>/dev/null | grep -E "^(FAL_KEY|ELEVENLABS_API_KEY|REPLICATE_API_TOKEN|GROQ_API_KEY)=" || echo "No API keys found in .env"
必需项：FAL_KEY
这是视频生成的最低要求。
- 提供商：Fal.ai
- 获取地址：https://fal.ai/dashboard/keys
- 免费额度：有（额度有限）
- 用途：图像生成（Flux）、视频生成（Wan 2.5、Kling）
如果用户没有 FAL_KEY：
- 引导其前往 https://fal.ai/dashboard/keys
- 需要创建账户并生成 API 密钥
- 添加到项目根目录的 .env 文件中
可选项（缺失时警告，但可继续）：
- 音乐生成：ELEVENLABS_API_KEY，提供商 ElevenLabs，获取地址 https://elevenlabs.io/app/settings/api-keys
- 语音/语音合成：ELEVENLABS_API_KEY，提供商 ElevenLabs，获取地址 https://elevenlabs.io/app/settings/api-keys
- 口型同步：REPLICATE_API_TOKEN，提供商 Replicate，获取地址 https://replicate.com/account/api-tokens
- 转录：GROQ_API_KEY，提供商 Groq，获取地址 https://console.groq.com/keys
当密钥缺失时，告知用户哪些功能不可用。
第二步：运行视频
bunx vargai render video.tsx
关键组件
<Render>：根容器，无需密钥<Clip>：顺序片段，无需密钥<Image>：AI 图像，需要 FAL<Video>：AI 视频，需要 FAL<Music>：背景音乐，需要 ElevenLabs<Speech>：文本转语音，需要 ElevenLabs
常见模式
角色一致性：
const character = Image({ prompt: "blue robot" });
// Reuse same reference for consistent appearance
<Video prompt={{ text: "waving", images: [character] }} />
<Video prompt={{ text: "dancing", images: [character] }} />
转场：
<Clip transition={{ name: "fade", duration: 0.5 }}>
// Options: fade, crossfade, wipeleft, cube, slideup, etc.
宽高比：
- 9:16 - TikTok、Reels、Shorts（竖屏）
- 16:9 - YouTube（横屏）
- 1:1 - Instagram（方形）
适用场景
适用于创建视频、动画、会说话的角色、幻灯片或社交媒体内容。
限制
使用前必须配置 FAL_KEY，否则无法进行视频生成。音乐、语音、口型同步和转录功能分别依赖对应的可选密钥，缺失时相关功能不可用。其他限制暂未提供。