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

## v2.0.20 — Entity ids on generate-image

`POST /v1/tools/generate-image` now accepts optional actor, product, and visual-style entity ids. The model uses them as identity/reference the same way in-app image generation does.

### Added

- **`entityIds` on generate-image:** pass `vg_enti_...` ids on `POST /v1/tools/generate-image` (and the matching MCP / agent tools). You can combine them with `imageFileIds`. A missing id returns not found. An inaccessible id returns a permission error.

## v2.0.21 — Spoken dialogue, start frame, and longer clips on generate-video-clip

`POST /v1/tools/generate-video-clip` now accepts `spokenDialogue` (the exact line the subject should speak as native, lip-synced speech) and `voiceDescription` (how that voice should sound). The model synthesizes the voice from that text. `audioFileIds` still accepts a reference recording for lip-sync from that file. You can pass spoken text, reference audio, or both.

Clip length on generate-video-clip is a whole number from 1 to 30 seconds and is clamped to the selected quality's supported range.

### Added

- **`spokenDialogue` on generate-video-clip:** optional string on `POST /v1/tools/generate-video-clip` (and the matching MCP / agent tools). Can be the only input. Combine it with a visual `prompt`, `startFrameFileId`, or reference media. At least one of `prompt`, `startFrameFileId`, `imageFileIds`, `videoFileIds`, `audioFileIds`, or `spokenDialogue` must be provided.
- **`voiceDescription` on generate-video-clip:** optional string describing the voice that speaks `spokenDialogue` (for example, a warm, confident young man's voice). Used when `spokenDialogue` is set. When omitted, a clear natural voice is used.
- **`startFrameFileId` on generate-video-clip:** optional file id of the opening-frame still. When set, that image is the first frame of the clip. If the same id also appears in `imageFileIds`, it is used only as the opening frame. Can be the only input.

### Changed

- **Clip duration:** `durationSeconds` on `POST /v1/tools/generate-video-clip` is a whole number from 1 to 30 (was 1 to 15). The generated clip is clamped to the selected quality's supported range. `POST /v1/workflows/prompt-to-video-clip` uses the same 1–30 window.

## v2.0.22 — Suppress background music on generate-video-clip

`POST /v1/tools/generate-video-clip` now accepts `suppressBackgroundMusic`. When true, the generated clip will not include a musical soundtrack. Spoken dialogue and environmental sound are still allowed. Use this when you will add background music separately, for example at the project level.

### Added

- **`suppressBackgroundMusic` on generate-video-clip:** optional boolean on `POST /v1/tools/generate-video-clip` (and the matching MCP / agent tools). Defaults to `false`.

> HTTP API with TypeScript and Python SDKs for generating image, video, and audio assets with VideoGen.