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.

AI agents

The MCP server is the supported way to give an agent VideoGen. Use the hosted remote endpoint, or run @videogen/mcp locally. For a custom agent in code, install the TypeScript or Python SDK and bind a function, as in Use with AI agents.

MCP server

Hosted remote (recommended) or local @videogen/mcp.

Use with AI agents

Bind the TypeScript or Python SDK in your framework.