VideoGen API

VideoGen provides official hand-written SDKs and a CLI that track the public OpenAPI surface. The SDKs include helpers for polling, file management, and webhook verification. The CLI wraps @videogen/sdk and exposes videogen <resource> <kebab-op> commands.

Library	Package	GitHub
TypeScript	npm: @videogen/sdk	GitHub
Python	PyPI: videogen	GitHub
CLI	npm: @videogen/cli	GitHub

Quick install

TypeScript

Python

CLI

$ npm install @videogen/sdk

SDK helpers

Both SDKs ship convenience helpers on top of the client (named exports and bound methods). Tools, workflows, and projects also expose *AndWait / *_and_wait wrappers that start work and poll to completion.

Helper	Purpose
`pollWorkflowRun`	Poll a workflow run until it reaches a terminal status (`succeeded`, `failed`, `cancelled`).
`pollProjectExport`	Poll a project export until it reaches a terminal status (`succeeded`, `failed`).
`pollExecutedTool`	Poll a tool execution until it reaches a terminal status (`succeeded`, `failed`, `cancelled`).
`pollRemixActions`	Poll remix actions on a project until all reach a terminal status.
`uploadFile`	Create a file upload, PUT the bytes, and poll until processed.
`downloadFile`	Hydrate a file’s download URL and fetch the content (optionally stream to disk).
`getHydratedFile`	Fetch a file and refresh signed URLs if they are missing or expired.
`pollPublicPreview`	After `enablePublicPreview`, poll `getFile` until `staticPublicPreviewSource` (and optionally `publicPlaybackId` for video/audio) are ready. Throws if public preview is not enabled.
`createPublicPreview`	Enable public preview and poll until preview / embed URLs are ready.
`verifyWebhookSignature`	Verify a Standard Webhooks signature on an incoming delivery; returns the parsed event.

See the per-language pages for usage examples and configuration details:

TypeScript

Node.js, Bun, and edge runtimes.

Python

Sync and async clients.

CLI

Single binary for terminals, scripts, and CI.

Agent framework tools

Building an AI agent? These packages return the full VideoGen tool set (34 tools) in your framework’s native format, so an agent can generate videos, images, voiceovers, sound effects, music, and avatars on demand. Each wraps the official SDK and runs as the team that owns your API key.

Framework	Package
Vercel AI SDK	npm: @videogen/ai-tool
LangChain	PyPI: langchain-videogen
CrewAI	PyPI: crewai-videogen
OpenAI Agents SDK	PyPI: openai-agents-videogen · npm: @videogen/openai-agents
LlamaIndex	PyPI: llama-index-tools-videogen
Pydantic AI	PyPI: pydantic-ai-videogen
Composio	PyPI: composio-videogen