GET

/v1/schemas/fal/video/minimax/h3-max/reference-to-video

Accept:

kind inputactivity videohash 30a9272e…extracted Nov 7, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `f17025d45546819b2878b1f1c66a37f57f04b409785b55455f24f6d70c4c8350` { "fetchedAt": 1794027603, "extractorVersion": "1", "verifiedAt": null }

Request body

17 properties · 2 required · 1 $defs

property	type	description	constraints
prompt_expansion_mode*	string	How much effort to spend rewriting the prompt before generation. 'disabled' skips prompt expansion. 'balanced' returns in about a second. 'quality' spends up to ~30s on a richer prompt.	default: "balanced"
prompt*	string	Text prompt for video generation. Refer to reference assets by their modality and order in the reference lists: Image 1, Image 2, Video 1, Audio 1, and so on.	length ≥ 1 · length ≤ 50000
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. Cannot be combined with reference audio. Longer clips are trimmed to the generated video's length, keeping the beginning; shorter clips are padded with silence. The clip is resampled to 32 kHz stereo and replaces the output soundtrack without changing playback speed. Accepts an HTTP(S) URL or a base64 data URI.	length ≥ 1 · nullable
aspect_ratio	enum	The aspect ratio of the generated video.	adaptive \| 21:9 \| 16:9 \| 4:3 \| 1:1 \| 3:4 · +1 more · default: "adaptive"
resolution	enum	The native generation resolution, or 1080P latent refinement from a native 768P source.	480P \| 768P \| 1080P · default: "768P"
reference_audio_urls	string[]	URLs of reference audio clips (2-15 seconds each, combined duration at most 15 seconds), referenced in the prompt as Audio 1, Audio 2, and so on. Images, videos, and audio can be provided individually or together. Reference images, videos, and audio clips must…	items ≤ 3
image_url	string	Optional URL of the image to use as the first frame. The video opens exactly on this image while the references keep the subjects consistent; the output canvas follows this image.	length ≥ 1 · nullable
sync_mode	boolean	Return the generated video as base64 instead of a CDN URL.	default: false
middle_image_url	string	Optional image to guide the video at middle_frame_time. Requires start and end images and native 480P or 768P resolution.	length ≥ 1 · nullable
seed	integer	Random seed. A random seed is selected when omitted.	nullable
middle_frame_time	number	Target time for the middle image, in seconds from the start. Rounded to the nearest frame at 24 fps; it must fall strictly between the first and last frames of the requested duration. Requires middle_image_url.	0 < n < 15 · nullable
reference_video_urls	string[]	URLs of motion/reference video clips (2-15 seconds each, combined duration at most 15 seconds), referenced in the prompt as Video 1, Video 2, and so on. Reference images, videos, and audio clips must add up to at most 12 files.	items ≤ 3
reference_image_urls	string[]	URLs of subject/style reference images, referenced in the prompt as Image 1, Image 2, and so on. Reference images, videos, and audio clips must add up to at most 12 files.	items ≤ 9
duration	number	Video length in seconds. The output can run up to about 0.7 s longer than requested. Use at least 2 s with target_audio_url.	0.92 ≤ n ≤ 15 · default: 5
reference_conditions	ReferenceCondition[]	Ordered reference list; cross-modality order is semantic and is preserved end-to-end. Do not combine with reference_*_urls.	items ≤ 12
end_image_url	string	Optional URL of the image to use as the last frame. The video ends exactly on this image.	length ≥ 1 · nullable

Types

1 $defs

ReferenceConditionobject

One ordered Ref2VA media condition.

url*	string	URL of the reference media.	length ≥ 1
type*	enum	Reference modality. Cross-modality list order is semantic.	image \| video \| audio

Validate a payload

before you spend tokens

shell

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