vargHQ/sdk

它解决了什么

此 SDK 通过提供统一的 API 与声明式的方式来组合视频，简化了创建 AI 生成视频的复杂过程。开发者无需分别管理多个图像、视频、语音和音乐的 AI 提供商，只需使用一个 API Key 即可访问多种高端模型（如 Kling、Flux、ElevenLabs），并使用 JSX 组件来构建视频。

它如何工作

用户像在 React 中构建 UI 一样，以声明式 JSX 组件（例如 <Clip>、<Video>、<Music>、<Captions>）编写视频。这些组件会发送到 varg API，API 将请求路由到相应的 AI 提供商，然后将生成的资产传递给渲染引擎，生成最终的 .mp4 文件。系统具备自动缓存功能，如果使用相同的 props，结果会直接从缓存中获取，免去重新生成的费用。

适用人群

• AI 代理：SDK 提供可安装到 Claude Code、Cursor、Windsurf 等代理的“技能”，让它们能够通过提示生成视频。
• 开发者：想使用类似 React 的语法和统一的供应商接口，以编程方式创建 AI 视频的 TypeScript 开发者。

亮点

• 统一 API：通过一个 API Key 访问多种视频、图像和音频模型。
• 基于 JSX 的组合：使用 <TalkingHead>、<Captions>、<Split> 等组件组合视频。
• 代理工作流：通过可安装的技能直接与 AI 代理集成。
• 自动缓存：通过避免重复生成降低成本并加速重新渲染。
• 丰富的组件库：包含 67 种 GL 转场和各种字幕样式（如 TikTok、Karaoke）。
• 灵活渲染：支持通过 CLI 本地渲染和云端渲染。