GET

/v1/schemas/openai/video/videos

Accept:

kind inputactivity videohash c148987e…extracted Jul 6, 2026version currentsource upstream spec ↗

Request body

5 properties · 1 required · 4 $defs

property	type	description	constraints
prompt*	string	Text prompt that describes the video to generate.	length ≥ 1 · length ≤ 32000
model	string \| enum	The video generation model to use (allowed values: sora-2, sora-2-pro). Defaults to `sora-2`.
input_reference	ImageRefParam-2	Optional reference object that guides generation. Provide exactly one of `image_url` or `file_id`.
seconds	enum	Clip duration in seconds (allowed values: 4, 8, 12). Defaults to 4 seconds.	4 \| 8 \| 12
size	enum	Output resolution formatted as width x height (allowed values: 720x1280, 1280x720, 1024x1792, 1792x1024). Defaults to 720x1280.	720x1280 \| 1280x720 \| 1024x1792 \| 1792x1024

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"openai","endpointId":"videos","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}