Changelog

August 14, 2026

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.