GET

/v1/schemas/openai/video/videos

Accept:

kind inputactivity videohash f95724e5…extracted Aug 15, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `49bac5ba25ea5ce2dfd77d18652ae21b60f5880d5b9373e30942d2be88b8be88` { "fetchedAt": 1786770656, "extractorVersion": "1", "verifiedAt": null }

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	string \| object
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

Types

4 $defs

ImageRefParam-2object

image_url	string	A fully qualified URL or base64-encoded data URL.	length ≤ 20971520 · format: uri
file_id	string

VideoModelstring | enum

VideoSecondsenum

4 | 8 | 12

VideoSizeenum

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", …}]}