VideoGenerationRequest - TypeScript SDK

VideoGenerationRequest type definition

The TypeScript SDK and docs are currently in beta. Report issues on GitHub.

Example Usage

1 import { VideoGenerationRequest } from "@openrouter/sdk/models";
2 
3 let value: VideoGenerationRequest = {
4   model: "google/veo-3.1",
5   prompt: "A serene mountain landscape at sunset",
6 };

Fields

Field	Type	Required	Description	Example
`aspectRatio`	models.AspectRatio	➖	Aspect ratio of the generated video	16:9
`callbackUrl`	string	➖	URL to receive a webhook notification when the video generation job completes. Overrides the workspace-level default callback URL if set. Must be HTTPS.	https://example.com/webhook
`duration`	number	➖	Duration of the generated video in seconds	8
`frameImages`	models.FrameImage[]	➖	Images to use as the first and/or last frame of the generated video. Each image must specify a frame_type of first_frame or last_frame.
`generateAudio`	boolean	➖	Whether to generate audio alongside the video. Defaults to the endpoint’s generate_audio capability flag, false if not set.	true
`inputReferences`	models.ContentPartImage[]	➖	Reference images to guide video generation
`model`	string	✔️	N/A
`prompt`	string	✔️	N/A
`provider`	models.VideoGenerationRequestProvider	➖	Provider-specific passthrough configuration
`resolution`	models.Resolution	➖	Resolution of the generated video	720p
`seed`	number	➖	If specified, the generation will sample deterministically, such that repeated requests with the same seed and parameters should return the same result. Determinism is not guaranteed for all providers.
`size`	string	➖	Exact pixel dimensions of the generated video in “WIDTHxHEIGHT” format (e.g. “1280x720”). Interchangeable with resolution + aspect_ratio.	1280x720

1	import { VideoGenerationRequest } from "@openrouter/sdk/models";
2
3	let value: VideoGenerationRequest = {
4	model: "google/veo-3.1",
5	prompt: "A serene mountain landscape at sunset",
6	};