View raw JSON
{
"type": "object",
"required": [],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"seed": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0,
"description": "Optional integer from 0 to 2147483647. Helps reuse a random starting value, without guaranteeing identical motion, subjects or videos."
},
"audio": {
"type": "boolean",
"default": true,
"description": "Optional boolean, default true. true enables an output audio track; false requests silent video. It does not promise that the original source soundtrack will be preserved."
},
"media": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"url"
],
"properties": {
"url": {
"type": "string",
"minLength": 1,
"description": "Required nonempty public HTTPS URL; no HTTP, base64 or local file path. Images: JPG/JPEG, PNG without alpha, BMP or WEBP, ≤20 MB, sides 240–8000 pixels, aspect 1:8–8:1. Videos: MP4/MOV, ≤100 MB, 1–15 seconds, ≥16 fps, sides 240–4096 pixels, aspect 1:8–8:1. Audio: WAV/MP3, ≤15 MB, 1–15 seconds. Files: docx/xlsx/pptx/pdf/txt/md, ≤100 MB and up to 50 pages where applicable. A link must be a public webpage requiring no login."
},
"type": {
"enum": [
"first_frame",
"last_frame",
"reference_image",
"reference_video",
"reference_audio",
"file",
"link"
],
"type": "string",
"description": "Required: first_frame, last_frame, reference_image, reference_video, reference_audio, file or link. Use one first frame alone or with one last frame, never last-only or mixed with references/files/links. References may combine: up to 10 images, 5 videos and 5 audio clips. They may also use one file or one link; file and link are mutually exclusive, with at most one of each."
}
},
"additionalProperties": false
},
"description": "Supply an eligible nonempty array if there is no prompt; otherwise optional. Every entry needs type and url. Image, video and audio references are ordered separately by type. Each reference clip is 1–15 seconds, and this Tool limits combined video-and-audio input duration to 15 seconds. For text-only generation, omit media."
},
"ratio": {
"enum": [
"adaptive",
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
],
"type": "string",
"default": "adaptive",
"description": "Optional adaptive (default), 16:9, 9:16, 1:1, 4:3 or 3:4. adaptive lets the model choose a suitable ratio from the input and intent; 21:9 is not an exposed choice."
},
"prompt": {
"type": "string",
"maxLength": 20000,
"minLength": 1,
"description": "Nonempty text up to 20000 characters when supplied. At least prompt or eligible media is needed. Describe a new clip or the edit; refer to reference assets as Image 1, Video 1 and Audio 1, numbered separately in each type’s array order. Longer text exceeds this Tool’s accepted length."
},
"duration": {
"anyOf": [
{
"type": "integer",
"maximum": 30,
"minimum": 2
},
{
"type": "string",
"const": "auto"
}
],
"default": 5,
"description": "Optional integer from 2 to 30 seconds, default 5, or the string auto for model-selected length. With reference video, total input-video duration plus output duration must not exceed 30 seconds. Use an explicit length to state the desired clip duration; -1 is not accepted here."
},
"watermark": {
"type": "boolean",
"default": false,
"description": "Optional boolean, default false. true requests an AI Generated watermark."
},
"resolution": {
"enum": [
"480P",
"720P",
"1080P"
],
"type": "string",
"default": "720P",
"description": "Optional 480P, 720P (default) or 1080P. Sets the requested output resolution tier; review the actual completed video."
},
"prompt_extend": {
"type": "boolean",
"default": true,
"description": "Optional boolean, default true. Rewrites the description and adds processing time, without guaranteeing better fidelity. It must be true when a file or webpage link is supplied."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}