GET

/v1/schemas/together/video/v2/videos

Accept:

kind inputactivity videohash fbb50bbe…extracted Oct 22, 2026version currentsource upstream spec ↗

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

Request body

16 properties · 1 required · 5 $defs

property	type	description	constraints
model*	string	The model to be used for the video creation request.
prompt	string	Text prompt that describes the video to generate.	length ≥ 1 · length ≤ 32000
height	integer
width	integer
resolution	string	Video resolution.
ratio	string	Aspect ratio of the video.
seconds	string	Clip duration in seconds.
fps	integer	Frames per second. Defaults to 24.
steps	integer	The number of denoising steps the model performs during video generation. More steps typically result in higher quality output but require longer processing time.	10 ≤ n ≤ 50
seed	integer	Seed to use in initializing the video generation. Using the same seed allows deterministic video generation. If not provided a random seed is generated for each request.
guidance_scale	integer	Controls how closely the video generation follows your prompt. Higher values make the model adhere more strictly to your text description, while lower values allow more creative freedom. guidence_scale affects both visual content and temporal consistency.Recom…
output_format	enum	Specifies the format of the output video. Defaults to MP4.	MP4 \| WEBM
output_quality	integer	Compression quality. Defaults to 20.
negative_prompt	string	Similar to prompt, but specifies what to avoid instead of what to include
generate_audio	boolean	Whether to generate audio for the video.
media	VideoMedia	Media inputs for video generation. The accepted fields depend on the model type (e.g. i2v, r2v, t2v, videoedit).

Types

5 $defs

AudioRefobject

audio*

string

URL of the audio.

VideoFrameImageInputobject

input_image*	string	URL path to hosted image that is used for a frame
frame	number \| enum	Optional param to specify where to insert the frame. If this is omitted, the following heuristics are applied: - frame_images size is one, frame is first. - If size is two, frames are first and last. - If size is larger, frames are first, last and evenly space…

VideoMediaobject

Contains all media inputs for video generation. Accepted fields depend on the model type.

frame_images	VideoFrameImageInput[]	Array of images to guide video generation at specific timeline positions.
frame_videos	VideoRef[]	Array of video clips to use as starting clips.
reference_images	string[]	Array of image URLs that guide the general appearance across the video.
reference_videos	VideoRef[]	Array of reference videos.
source_video	string \| object	Source video to edit. Accepts a URL string or an object with a "video" key.
audio_inputs	string \| AudioRef[]	Array of audio inputs. Each element accepts a URL string or an object with an "audio" key.

VideoOutputFormatenum

MP4 | WEBM

VideoRefobject

video*

string

URL of the video.

Validate a payload

before you spend tokens

shell

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