GET

/v1/schemas/fal/video/minimax/h3/image-to-video/lora

Accept:

kind inputactivity videohash 586a6dac…extracted Nov 11, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `ef3f54d59c6f1440a25e970600f636ab8845859faba1dd0db3246e7704aa9e7e` { "fetchedAt": 1794373202, "extractorVersion": "2", "verifiedAt": null }

Request body

12 properties · 2 required · 1 $defs

property	type	description	constraints
prompt*	string	Text prompt for video generation	length ≥ 1 · length ≤ 50000
loras*	LoRAInput[]	List of LoRA adapters to apply to the transformer.	items ≥ 1 · items ≤ 3
resolution	enum	The resolution of the generated video. 480P and 768P are native generation modes; 2K and 4K upscale a 768P base result.	480P \| 768P \| 2K \| 4K · default: "2K"
image_url	string	Optional URL of the image to use as the first frame. When provided, the output canvas follows this image. If only end_image_url is provided, the canvas follows that last frame instead. If both images are omitted, the request is handled as text-to-video (16:9 by default).	nullable
enable_safety_checker	boolean	If set to true, the safety checker will be enabled.	default: true
target_audio_url	string	Optional URL of an audio clip at least 2 seconds long (maximum 15 MB) to pin to the generated soundtrack. Longer clips are trimmed to the generated video's length, keeping the beginning. The original audio replaces the output soundtrack, padded with silence if shorter than the video, without changing playback speed. Exceptionally high sample rates may be resampled to 96 kHz. Accepts an HTTP(S) URL or a base64 data URI.	length ≥ 1 · nullable
duration	integer	The duration of the video in seconds.	5 ≤ n ≤ 15 · default: 5
seed	integer	Random seed. A random seed is selected when omitted.	nullable
prompt_expansion_mode	string	How much effort to spend rewriting the prompt before generation. 'disabled' skips prompt expansion. 'fast' returns in about a second. 'balanced' picks per request. 'quality' spends up to ~30s on a richer prompt.	nullable
aspect_ratio	enum	The aspect ratio of the generated video. 'adaptive' follows the input image; a fixed ratio center-crops the keyframes to fit. Without keyframes, 'adaptive' generates 16:9.	adaptive \| 21:9 \| 16:9 \| 4:3 \| 1:1 \| 3:4 · +1 more · default: "adaptive"
end_image_url	string	Optional URL of the image to use as the last frame. It may be provided alone for end-only keyframe generation; in that case the output canvas follows this image.	nullable
sync_mode	boolean	Return the generated video as base64 instead of a CDN URL.	default: false

Types

1 $defs

LoRAInputobject

A single LoRA adapter to apply to the transformer.

scale	number	Strength of the LoRA (0.0 to 4.0).	0 ≤ n ≤ 4 · default: 1
weight_name	string	Name of the LoRA weight file. Only used when `path` is a HuggingFace repo and it holds more than one LoRA.	nullable
path*	string	URL or HuggingFace repo id (owner/repo) of the LoRA weights.

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"minimax/h3/image-to-video/lora","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}