GET

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

Accept:

kind inputactivity videohash 37eaa6f3…extracted Nov 7, 2026version currentsource upstream spec ↗

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

Request body

13 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
sync_mode	boolean	Return the generated video as base64 instead of a CDN URL.	default: false
seed	integer	Random seed. A random seed is selected when omitted.	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. 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_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
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
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

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-turbo/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}