---
title: "VideoGenerationRequest"
---

## Fields

| Field                                                                                                                                                                                                                                                           | Type                                                                                                                                                                                                                                                            | Required                                                                                                                                                                                                                                                        | Description                                                                                                                                                                                                                                                     | Example                                                                                                                                                                                                                                                         |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `aspect_ratio`                                                                                                                                                                                                                                                  | [Optional[components.VideoGenerationRequestAspectRatio]](../components/videogenerationrequestaspectratio.mdx)                                                                                                                                                    | :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](../components/frameimage.mdx)]                                                                                                                                                                                                      | :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.InputReference](../components/inputreference.mdx)]                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                                                                              | Reference assets to guide video generation. Accepts image, audio, and video references. Audio and video references are only honored by providers that support them (currently BytePlus Seedance 2.0); other providers use image references and ignore the rest. |                                                                                                                                                                                                                                                                 |
| `model`                                                                                                                                                                                                                                                         | *str*                                                                                                                                                                                                                                                           | :heavy_check_mark:                                                                                                                                                                                                                                              | N/A                                                                                                                                                                                                                                                             |                                                                                                                                                                                                                                                                 |
| `prompt`                                                                                                                                                                                                                                                        | *str*                                                                                                                                                                                                                                                           | :heavy_check_mark:                                                                                                                                                                                                                                              | N/A                                                                                                                                                                                                                                                             |                                                                                                                                                                                                                                                                 |
| `provider`                                                                                                                                                                                                                                                      | [Optional[components.VideoGenerationRequestProvider]](../components/videogenerationrequestprovider.mdx)                                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                                                                                              | Provider-specific passthrough configuration                                                                                                                                                                                                                     |                                                                                                                                                                                                                                                                 |
| `resolution`                                                                                                                                                                                                                                                    | [Optional[components.VideoGenerationRequestResolution]](../components/videogenerationrequestresolution.mdx)                                                                                                                                                      | :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                                                                                                                                                                                                                                                        |