> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.videogen.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.videogen.io/_mcp/server.

## 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.