GET

/v1/schemas/openai/video/videos?kind=output

Accept:

kind outputactivity videohash fe66aaff…extracted Oct 16, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `0de11ff21ce812512e44fb71d7ce590fe5d3b97c22041977f3db01c0d4db2805` { "fetchedAt": 1792127445, "extractorVersion": "1", "verifiedAt": null }

Response body

13 properties · 13 required · 8 $defs

property	type	description	constraints
id*	string	Unique identifier for the video job.
object*	enum	The object type, which is always `video`.	video · default: "video"
model*	string \| enum	The video generation model that produced the job.
status*	enum	Current lifecycle status of the video job.	queued \| in_progress \| completed \| failed
progress*	integer	Approximate completion percentage for the generation task.
created_at*	integer	Unix timestamp (seconds) for when the job was created.	format: unixtime
completed_at*	integer	Unix timestamp (seconds) for when the job completed, if finished.	format: unixtime · nullable
expires_at*	integer	Unix timestamp (seconds) for when the downloadable assets expire, if set.	format: unixtime · nullable
prompt*	string	The prompt that was used to generate the video.	nullable
size*	enum	The resolution of the generated video.	720x1280 \| 1280x720 \| 1024x1792 \| 1792x1024
seconds*	string \| enum	Duration of the generated clip in seconds. For extensions, this is the stitched total duration.
remixed_from_video_id*	string	Identifier of the source video if this video is a remix.	nullable
error*	Error-2	Error payload that explains why generation failed, if applicable.	nullable

Types

8 $defs

_MisalignmentErrorTypestring | enum

_MisalignmentSteerobject

message*

string

The public continuation instruction.

Error-2object

An error that occurred while generating the response.

code*	string	A machine-readable error code that was returned.
message*	string	A human-readable description of the error that was returned.
headers	object	The Retry-After and Retry-After-Ms headers returned with the original error, if any.
misalignment	MisalignmentErrorDetailsResource
param	string	The request parameter associated with the error, or null if none was recorded.	nullable
type	string	The original error type, or null if it was not recorded.	nullable

MisalignmentErrorDetailsResourceobject

review_target	string	An opaque target for explicitly continuing this review, or null when unavailable.	length ≥ 1 · length ≤ 96 · nullable
error_type	string \| enum	An optional classification; clients must accept additional values.
detailed_explanation	string	The public explanation for this block.
steer	_MisalignmentSteer	An optional public continuation instruction.

VideoModelstring | enum

VideoSecondsenum

4 | 8 | 12

VideoSizeenum

720x1280 | 1280x720 | 1024x1792 | 1792x1024

VideoStatusenum

queued | in_progress | completed | failed

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