GET
/v1/schemas/together/video/videos
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace468edbdc879c48f500ca284270663ccc30cd83aee57a4e6a4e7a5bc04603b543{
"fetchedAt": 1786771359,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
18 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). | |
| frame_images | VideoFrameImageInput[] | Deprecated: use media.frame_images instead. Array of images to guide video generation, similar to keyframes. | deprecated |
| reference_images | string[] | Deprecated: use media.reference_images instead. Unlike frame_images which constrain specific timeline positions, reference images guide the general appearance that should appear consistently across the video. | deprecated |
Types
5 $defsAudioRefobject
| 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 tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"together","endpointId":"videos","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}