Fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
aspect_ratio | Optional[components.AspectRatio] | :heavy_minus_sign: | Aspect ratio of the generated video | 16:9 |
callback_url | Optional[str] | :heavy_minus_sign: | 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 | Optional[int] | :heavy_minus_sign: | Duration of the generated video in seconds | 8 |
frame_images | List[components.FrameImage] | :heavy_minus_sign: | 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. | |
generate_audio | Optional[bool] | :heavy_minus_sign: | Whether to generate audio alongside the video. Defaults to the endpoint’s generate_audio capability flag, false if not set. | true |
input_references | List[components.ContentPartImage] | :heavy_minus_sign: | Reference images to guide video generation | |
model | str | :heavy_check_mark: | N/A | |
prompt | str | :heavy_check_mark: | N/A | |
provider | Optional[components.VideoGenerationRequestProvider] | :heavy_minus_sign: | Provider-specific passthrough configuration | |
resolution | Optional[components.Resolution] | :heavy_minus_sign: | Resolution of the generated video | 720p |
seed | Optional[int] | :heavy_minus_sign: | 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 | Optional[str] | :heavy_minus_sign: | Exact pixel dimensions of the generated video in “WIDTHxHEIGHT” format (e.g. “1280x720”). Interchangeable with resolution + aspect_ratio. | 1280x720 |