View raw JSON
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"prompt",
"media"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"seed": {
"type": "integer",
"maximum": 2147483647,
"minimum": 0,
"description": "Optional integer from 0 to 2147483647. A fixed seed reuses a random starting point, but does not ensure the same scene, character appearance or voice."
},
"media": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"url"
],
"properties": {
"url": {
"type": "string",
"minLength": 1,
"description": "Required public HTTPS URL for the image or video. HTTP, Base64 and local-file inputs are not accepted. Images must be JPG/JPEG, PNG without alpha, BMP or WEBP, at most 20 MB, each side 240–8000 pixels and aspect ratio 1:8–8:1. Videos must be MP4 or MOV, 1–30 seconds, at most 100 MB, each side 240–4096 pixels and aspect ratio 1:8–8:1."
},
"type": {
"enum": [
"reference_image",
"reference_video",
"first_frame"
],
"type": "string",
"description": "Required value: reference_image for a character or setting, reference_video for a character, or first_frame for the opening composition. Each character reference must contain one character, which may be a person, animal or object; a background image can provide the scene. Avoid empty-scene videos as character references. References guide generation without guaranteeing exact likeness."
},
"reference_voice": {
"type": "string",
"minLength": 1,
"description": "Optional nonempty public HTTPS audio URL, only on reference_image or reference_video, not first_frame. Use WAV or MP3, 1–10 seconds and at most 15 MB. It guides voice characteristics, not spoken content. A supplied voice takes priority over reference-video audio; otherwise available video audio serves as its voice reference. Voice likeness, exact dialogue and lip-sync are not guaranteed."
}
},
"additionalProperties": false
},
"minItems": 1,
"description": "Required nonempty array containing at least one reference_image or reference_video. Those two types may total at most five entries. You may add one first_frame separately, but a first frame alone does not satisfy the reference requirement. Keep the order: images and videos are numbered separately as Image 1 and Video 1 in the prompt."
},
"ratio": {
"enum": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
],
"type": "string",
"default": "16:9",
"description": "Optional 16:9, 9:16, 1:1, 4:3 or 3:4, default 16:9. When a first_frame is supplied, this setting is ignored and its image framing is used instead. It does not guarantee precise composition or character fidelity."
},
"prompt": {
"type": "string",
"maxLength": 5000,
"minLength": 1,
"description": "Required nonempty text, at most 5000 characters. Describe the new action or dialogue and identify references with capitalized, spaced names such as Image 1 and Video 1. Number images and videos separately in their array order. A voice sample does not supply the words to be spoken; describe desired dialogue here."
},
"duration": {
"type": "integer",
"default": 5,
"maximum": 15,
"minimum": 2,
"description": "Optional whole seconds, default 5. Image-only requests allow 2–15; if any reference_video is included, use 2–10. This is the newly generated scene length, not the original clip plus a continuation."
},
"watermark": {
"type": "boolean",
"default": false,
"description": "Optional boolean, default false. Set true to request the AI Generated watermark on the video."
},
"resolution": {
"enum": [
"720P",
"1080P"
],
"type": "string",
"default": "720P",
"description": "Optional 720P or 1080P, default 720P for this Tool. Select a tier for the generated video; resolution does not ensure sharper details or closer adherence to references."
},
"prompt_extend": {
"type": "boolean",
"default": true,
"description": "Optional boolean, default true. It allows the model to rewrite the prompt before generation and can increase processing time. Rewriting does not guarantee higher quality or faithful interpretation."
},
"negative_prompt": {
"type": "string",
"maxLength": 500,
"description": "Optional text, at most 500 characters, to guide exclusions. It does not guarantee that specified elements will be absent from the video."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}