v2.1.0 — Catalog entities, spoken clips, slideshow themes, and OpenClaw

Version 2.1 of the TypeScript SDK, Python SDK, CLI, MCP server, and OpenClaw plugin. List VideoGen’s built-in catalog on the Entities API, generate spoken lip-synced clips, theme slideshow-to-video decks, and install the OpenClaw plugin from npm or ClawHub.

Added

  • Built-in catalog on the Entities API: GET /v1/entities and GET /v1/entities/{entityId} include stock actors, products, visual styles, and slideshow themes alongside your team’s entities (catalog first). Responses include isBuiltIn (true for catalog rows). Filter with entityType when you only need one kind. Catalog entities cannot be updated, archived, or given references (400 invalid_parameters on /update, /archive, /references, and /references/remove).
  • Spoken dialogue on generate-video-clip: POST /v1/tools/generate-video-clip accepts spokenDialogue (the line to speak as native lip-synced speech), voiceDescription, and startFrameFileId. Clip length is a whole number from 1 to 30 seconds. Set suppressBackgroundMusic to true when you will add music separately.
  • Entity ids on generate-image and generate-motion-graphic: pass entityIds (vg_enti_...) so the model can use actors, products, or visual styles as identity or reference. You can combine them with file ids. A missing id returns not found. An inaccessible id returns a permission error.
  • ADD_ZOOM remix action: apply a Ken Burns zoom to every eligible still in a project, including uploads. No extra fields. Use it in remixActions on a workflow start or via POST /v1/projects/{projectId}/remix. See Remix actions.
  • Slideshow themes: create a SLIDESHOW_THEME entity with POST /v1/entities. POST /v1/workflows/slideshow-to-video accepts optional slideshowThemeEntityId. Omit it to convert uploaded PDF or PowerPoint pages as they are. VideoGen derives a theme from those pages so later slide edits can match the deck. A SLIDESHOW_THEME may attach a PDF or PowerPoint as a reference, not only images.
  • OpenClaw plugin: install @videogen/openclaw-plugin from npm or ClawHub (openclaw plugins install clawhub:@videogen/openclaw-plugin). The package ships compiled runtime JS and exposes the same workflows, tools, projects, files, and entities as the MCP server. Set VIDEOGEN_API_KEY (or plugin apiKey).

Fixed

  • API text-to-speech usage labels: TTS started from the API, including narration on API workflow runs, now shows as via the API on your usage page. Amounts are unchanged.