GET

/v1/schemas/openrouter/video/videos%2Fkwaivgi%2Fkling-v3.0-pro

kind inputactivity videohash 690e1a5dextracted Jul 26, 2026version currentsource upstream spec ↗

Request body

11 properties · 1 required · 6 $defs
propertytypedescriptionconstraints
model*enumModel id (fixed for this model-constrained schema)kwaivgi/kling-v3.0-pro
aspect_ratioenumAspect ratio of the generated video16:9 | 9:16 | 1:1
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
durationenumDuration of the generated video in seconds3 | 4 | 5 | 6 | 7 | 8 · +7 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.
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 (currently BytePlus Seedance 2.0); other providers use image references and ignore the rest.
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-specific passthrough configuration Passthrough parameters allowed for this model: negative_prompt, cfg_scale.
resolutionenumResolution of the generated video720p
sizeenumExact pixel dimensions of the generated video in "WIDTHxHEIGHT" format (e.g. "1280x720"). Interchangeable with resolution + aspect_ratio.1280x720 | 720x1280 | 720x720

Validate a payload

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