> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter-d02e98a0-mintlify-5b6e02fd.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# VideoGenerationRequest - Python SDK

> VideoGenerationRequest method reference

<Warning>
  The Python SDK and docs are currently in beta.
  Report issues on [GitHub](https://github.com/OpenRouterTeam/python-sdk/issues).
</Warning>

## Fields

| Field              | Type                                                                                                     | Required             | Description                                                                                                                                                                                               | Example                                                    |
| ------------------ | -------------------------------------------------------------------------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `aspect_ratio`     | [Optional\[components.AspectRatio\]](../components/aspectratio.md)                                       | :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](https://example.com/webhook) |
| `duration`         | *Optional\[int]*                                                                                         | :heavy\_minus\_sign: | Duration of the generated video in seconds                                                                                                                                                                | 8                                                          |
| `frame_images`     | List\[[components.FrameImage](/client-sdks/python/api-reference/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](/client-sdks/python/api-reference/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\]](../components/videogenerationrequestprovider.md) | :heavy\_minus\_sign: | Provider-specific passthrough configuration                                                                                                                                                               |                                                            |
| `resolution`       | [Optional\[components.Resolution\]](../components/resolution.md)                                         | :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                                                   |
