REST API ReferenceEndpointsTools

Generate video clip

Generate a single short video clip (up to 15 seconds) from a text prompt, optionally guided by reference images, videos, and audio. At least one of `prompt`, `imageFileIds`, `videoFileIds`, or `audioFileIds` must be provided. VideoGen automatically routes each request to the most effective state-of-the-art video model for your inputs and settings, so you don't pick a model. This endpoint returns one standalone clip. For longer, higher-quality, professionally edited videos with narration, captions, music, and multiple scenes, use a video workflow such as [Script to video](/workflows) (`POST /v1/workflows/script-to-video`) instead.

Authentication

AuthorizationBearer
API key from [app.videogen.io/developers](https://app.videogen.io/developers). The full key is only shown once when you create it.

Request

This endpoint expects an object.
qualityenumRequiredDefaults to STANDARD

Video generation quality tier. STANDARD is fastest; HIGH is slowest and highest quality.

promptstringOptional

Text prompt describing the video to generate. Optional when reference media is provided. Describe the video in plain language; any reference media you provide is incorporated automatically.

imageFileIdslist of stringsOptional

Optional file ids of reference images (e.g. ["vg_file_..."]). Upload files first via POST /v1/files/upload, then pass the returned ids here. When provided, the images are animated or used as visual guidance for the generated video.

videoFileIdslist of stringsOptional

Optional file ids of reference videos (e.g. ["vg_file_..."]). Upload files first via POST /v1/files/upload, then pass the returned ids here. They are used as motion or style guidance for the generated video.

audioFileIdslist of stringsOptional

Optional file ids of reference audio clips (e.g. ["vg_file_..."]) used for native lip-sync and soundtrack. Upload files first via POST /v1/files/upload, then pass the returned ids here.

generateAudiobooleanOptionalDefaults to false
When true, the generated video is guaranteed to include audio. When false, audio may still be present. Defaults to false.
durationSecondsinteger or nullOptional1-15

Desired clip length in seconds. A whole number between 1 and 15. Defaults to 6 when omitted. This endpoint produces a single short clip. For longer, multi-scene, professionally edited videos, use a video workflow such as POST /v1/workflows/script-to-video.

aspectRatioobjectOptional

Aspect ratio for the generated video. Defaults to 16:9 when omitted.

watermarkModeenumOptionalDefaults to AUTO

Controls whether the VideoGen watermark is applied to the output. AUTO applies the watermark unless you have the Production API add-on. VIDEO_GEN always applies it. NONE removes the watermark — requires the Production API add-on; returns an error if you don’t have it.

numResultsintegerOptional1-100Defaults to 1
Number of output results to generate. Defaults to 1.
isOutputTemporarybooleanOptionalDefaults to false

When true, generated files are temporary. Temporary files are guaranteed to be available for 24 hours, after which they may be archived at any time. Temporary files are not analyzed (no description, transcript, or embedding will be generated), so they will not appear in search results. Defaults to false.

Response

Execution accepted; poll until complete.

toolExecutionIdstring

Execution id (e.g. vg_tool_...).