v2.0.14 — Actor avatars, file controls, CLI OAuth, and motion graphics

This release adds actor-based avatar generation, team file controls, interactive CLI sign-in, and more control over motion graphics. It also expands the agent integration packages and removes several plan restrictions.

Added

  • Catalogue query filter: GET /v1/resources/languages, GET /v1/resources/tts-voices, and deprecated GET /v1/resources/avatar-presenters accept optional query for case-insensitive substring matching across each item’s searchable text fields.
  • Automation platforms: Zapier, Make, n8n, and Pipedream no longer expose the deprecated avatar-presenter catalogue (listAvatarPresenters) or deprecated avatarPresenterId request fields. Use actorEntityId instead.
  • Actor-based avatars: POST /v1/tools/generate-avatar now accepts actorEntityId for an ACTOR entity with an image reference. Use avatarQuality to select LOW, STANDARD, HIGH, or MAX.
  • Actor avatars in workflows: Script-to-video, voiceover-to-video, and slideshow-to-video accept actorEntityId and avatarQuality. The CHANGE_NARRATOR remix action accepts the same fields.
  • Team file listing: GET /v1/files now returns files accessible to your team. Pass selfOnly=true to restrict results to files created by the API key’s user.
  • Hidden generated files: Upload, media-generation, and video-workflow requests accept hideFromUi. Set it to true to keep generated files out of the VideoGen Media page while retaining API access.
  • Motion graphic capability controls: POST /v1/tools/generate-motion-graphic accepts subToolModes for generated images, generated video clips, generated voiceover, and stock media search. Set each capability to AUTO, ENABLED, or DISABLED.
  • Transparent motion graphics: POST /v1/tools/generate-motion-graphic accepts transparentBackground. It defaults to true and returns a transparent WebM suitable for overlays. Set it to false for an opaque MP4. MCP generate_motion_graphic supports the same option.
  • CLI OAuth: Run videogen login for interactive OAuth 2.1 sign-in with PKCE. Run videogen logout to clear cached credentials. Explicit --api-key credentials take priority, followed by VIDEOGEN_API_KEY, then the cached OAuth token.
  • MCP guidance: Four new tools and matching resources help agents choose between tools and workflows, handle asynchronous operations, follow the workflow-to-export flow, and configure authentication: get_getting_started_guidance, get_async_tasks_guidance, get_workflows_guidance, and get_tools_vs_workflows_guidance.
  • Python agent integrations: The Composio, CrewAI, LangChain, LlamaIndex, OpenAI Agents, and Pydantic AI packages now expose prompt_to_video_clip and generate_motion_graphic, along with the actor-avatar fields.
  • OpenClaw tools: The OpenClaw plugin now includes prompt_to_video_clip, generate_motion_graphic, get_project_export, get_app_deep_link, and the four MCP guidance tools.

Changed

  • API access on every plan: You can create multiple API keys and access authorized project and export files without the Production API add-on.
  • Pro branding controls: A Pro plan now allows watermarkMode: "NONE" and endScreenMode: "NONE". AUTO removes API branding on Pro and applies it below Pro.
  • File filters: includeExportFiles=true and includeProjectFiles=true no longer require the Production API add-on.
  • Text generation billing: POST /v1/text/generate now bills on AI-assistant token rates (input, output, and thinking tokens) instead of a separate per-character text-generation feature. Balance checks reserve your request’s maxOutputTokens before the model runs.
  • Image and video clip rates: Generated images and video clips use a flat per-image or per-output-second rate. Reference images, input video seconds, and input audio seconds are no longer billed as separate line items.

Deprecated

  • Legacy avatar presenters: avatarPresenterId, GET /v1/resources/avatar-presenters, and MCP list_avatar_presenters remain available for compatibility but are deprecated. New integrations should use actorEntityId.

Fixed

  • Hosted MCP OAuth: Sign in with VideoGen on the hosted MCP server now completes more reliably in Cursor.