GET
/v1/schemas/fal/video/minimax/h3-max/multi-angle/image-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace48adbf35b9ad527239e7133c49f7aab428a7afa8cf428bba964df4c7a561d4be{
"fetchedAt": 1789102803,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
9 properties · 2 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| image_url* | string | URL of the image to use as the first frame. | length ≥ 1 |
| prompt_expansion_mode* | string | How much effort to spend rewriting the prompt before generation. 'balanced' returns in about a second. 'quality' spends up to ~30s on a richer prompt. | default: "balanced" |
| prompt | string | Text prompt for video generation. When omitted or blank, defaults to preserving the frozen reference scene while only the camera moves. | length ≤ 50000 · default: "The same elements in the refere… |
| sync_mode | boolean | Return the generated video as base64 instead of a CDN URL. | default: false |
| enable_safety_checker | boolean | If set to true, the safety checker will be enabled. | default: true |
| resolution | enum | The native generation resolution, or 1080P latent refinement from a native 768P source. | 480P | 768P | 1080P · default: "480P" |
| camera_trajectory | H3MaxCameraKeyframe[] | Ordered camera keyframes. The first pose is held before its time and the final pose is held for the remainder of the video. Signed full turns are preserved, with at most 32 turns of total azimuth travel. | items ≥ 2 · items ≤ 12 |
| 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 |
Types
1 $defsH3MaxCameraKeyframeobject
One camera pose at a normalized point in the generated clip.
| distance* | number | Camera distance from the subject in normalized scene units. | n > 0 |
| elevation* | number | Vertical camera angle around the subject, in degrees. | -90 ≤ n ≤ 90 |
| azimuth* | number | Horizontal camera angle around the subject, in degrees. | |
| time* | number | Normalized video time, from 0 at the start to 1 at the end. | 0 ≤ n ≤ 1 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"minimax/h3-max/multi-angle/image-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}