GET

/v1/schemas/openrouter/video/videos%2Fbytedance%2Fseedance-2.0

kind inputactivity videohash 1647ebb1…extracted Nov 22, 2026version currentsource upstream spec ↗

Request body

18 properties · 1 required · 8 $defs
propertytypedescriptionconstraints
model*enumModel id (fixed for this model-constrained schema)bytedance/seedance-2.0
aspect_ratioenumAspect ratio of the generated video. Omit it to use the model default, which on models with adaptive aspect ratio (e.g. BytePlus Seedance) follows the input image or video.1:1 | 3:4 | 9:16 | 4:3 | 16:9 | 21:9 · +1 more
callback_urlstringURL to receive a webhook notification when the video generation job completes. Overrides the workspace-level default callback URL if set. Must be HTTPS.format: uri
creativityintegerCreativity level for video upscaling models only. This parameter is not supported by video generation models.
durationenumDuration of the generated video in seconds, or -1 to let the provider choose the length (e.g. following an input video). -1 is only accepted by models that list it in supported_durations.4 | 5 | 6 | 7 | 8 | 9 · +6 more · n ≥ -1
frame_imagesFrameImage[]Images to use as the first and/or last frame of the generated video. Each image must specify a frame_type of first_frame or last_frame. Frame types supported by this model: first_frame, last_frame.
generate_audiobooleanWhether to generate audio alongside the video. Defaults to the endpoint's generate_audio capability flag, false if not set. When neither is set, some providers (such as xAI) apply their own default and generate audio, so send false to request a silent video. S…
input_referencesInputReference[]Reference assets to guide video generation. Accepts image, audio, and video references. Audio and video references are only honored by providers that support them (including BytePlus Seedance generation 2 and newer); other providers use image references and ig…
previous_job_idstringID of a completed video job to edit or extend, as returned by the submit response. The new job runs on the same model and endpoint that produced the previous one. Only models that support continuation accept this field.
promptstringText prompt describing the video to generate. Optional for models that support generating a video from image input alone; required by all other models.
providerobjectProvider routing preferences (order, only, ignore), request-level data policy (zdr, data_collection) and provider-specific passthrough configuration. No video endpoint currently offers Zero Data Retention, so `zdr: true` fails routing. Passthrough parameters a…
resolutionenumResolution of the generated video480p | 720p | 1080p | 4K
seedintegerIf specified, the generation will sample deterministically, such that repeated requests with the same seed and parameters should return the same result. Determinism is not guaranteed for all providers.
session_idstringA unique identifier for grouping related requests (e.g., a conversation or agent workflow). Used for observability grouping in Broadcast and private logging; never sent to the provider. If provided in both the request body and the x-session-id header, the body…length ≤ 256
sizeenumExact pixel dimensions of the generated video in "WIDTHxHEIGHT" format (e.g. "1280x720"). Interchangeable with resolution + aspect_ratio.480x480 | 480x640 | 480x854 | 640x480 | 854x480 | 1120x480 · +19 more
traceTraceConfigMetadata for observability and tracing. Known keys (trace_id, trace_name, span_name, generation_name, parent_span_id) have special handling. Additional keys are passed through as custom metadata to configured broadcast destinations.
upscale_factornumberUpscale factor for video upscaling models only. This parameter is not supported by video generation models.n ≥ 0 · format: double
userstringA unique identifier representing your end-user. Forwarded to Broadcast and private logging as the end-user id; never sent to the provider.length ≤ 256

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"openrouter","endpointId":"videos/bytedance/seedance-2.0","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}