GET
/v1/schemas/openrouter/video/videos
Accept:
Request body
12 properties · 1 required · 6 $defs| property | type | description | constraints |
|---|---|---|---|
| model* | string | ||
| aspect_ratio | enum | Aspect ratio of the generated video | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 3:2 · +3 more |
| callback_url | 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. | format: uri |
| duration | integer | Duration of the generated video in seconds | n ≥ 1 |
| frame_images | 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. | |
| generate_audio | boolean | Whether to generate audio alongside the video. Defaults to the endpoint's generate_audio capability flag, false if not set. | |
| input_references | InputReference[] | 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. | |
| prompt | string | Text prompt describing the video to generate. Optional for models that support generating a video from image input alone; required by all other models. | |
| provider | object | Provider-specific passthrough configuration | |
| resolution | enum | Resolution of the generated video | 480p | 720p | 1080p | 1K | 2K | 4K |
| seed | integer | 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. |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"openrouter","endpointId":"videos","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}