vargHQ/sdk

它解決了什麼

此 SDK 透過提供統一的 API 與宣告式的影片組合方式，簡化了製作 AI 生成影片的複雜流程。開發者不必分別管理多個影像、影片、語音與音樂的 AI 供應商，只需要一組 API 金鑰即可存取多種高階模型（如 Kling、Flux、ElevenLabs），並以 JSX 元件來構建影片。

它如何運作

使用者以宣告式 JSX 元件（例如 <Clip>、<Video>、<Music>、<Captions>）撰寫影片，就像在 React 中建立 UI 一樣。這些元件會被送至 varg API，API 會將請求路由至相應的 AI 供應商，然後將產生的資產傳遞給渲染引擎，最終產出 .mp4 檔案。系統內建自動快取機制，若使用相同的 props，結果會直接從快取中取得，免除重新產生的成本。

目標對象

• AI 代理：SDK 提供可安裝於 Claude Code、Cursor、Windsurf 等代理的「技能」，讓它們能透過提示產生影片。
• 開發者：想以類 React 語法與統一的供應商介面，以程式方式產生 AI 影片的 TypeScript 開發者。

重點特色

• 統一 API：只需一組 API 金鑰即可存取多種影片、影像與音訊模型。
• 基於 JSX 的組合：使用 <TalkingHead>、<Captions>、<Split> 等元件組合影片。
• 代理工作流程：可直接透過可安裝的技能與 AI 代理整合。
• 自動快取：透過避免重複產生，降低成本並加速重新渲染。
• 豐富的元件庫：內含 67 種 GL 轉場與各式字幕樣式（如 TikTok、Karaoke）。
• 彈性渲染：支援 CLI 本地渲染與雲端渲染。