GET
/v1/schemas/fal/video/minimax/h3-max/extend-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace1a3720a8966d57a2fa7a2b67508392bedb566cb5541be9ad977c9aebaf2dcf85{
"fetchedAt": 1791349310,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
10 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| video_url* | string | URL of the video to extend. Must be 1.625 s to 60 s long, up to 50 MB, aspect ratio between 0.4 and 2.5. | length ≥ 1 |
| prompt* | string | What happens next. Describe the continuation, not the source. | length ≥ 1 · length ≤ 50000 |
| aspect_ratio | enum | Output aspect ratio. 'auto' follows the source video. Other values crop the video to fit the selected ratio. | auto | 21:9 | 16:9 | 4:3 | 1:1 | 3:4 · +1 more · default: "auto" |
| enable_prompt_expansion | boolean | Automatically enhance the prompt using the source video to help keep the continuation consistent. May increase processing time. | default: true |
| reference_audio_urls | string[] | Optional audio references for the continuation (2–15 seconds each, 15 seconds combined). The full extended video retains its original source soundtrack, and its ending still conditions the transition. These clips guide the newly generated audio instead of usin… | items ≤ 3 |
| output | enum | 'extended' returns the source and new footage as one video. 'continuation' returns a clip that starts with a 1.625-second repeat of the source's ending, then shows the new footage. | extended | continuation · default: "extended" |
| duration | number | Seconds of new footage to add. The continuation clip also includes 1.625 seconds from the source's ending and may be longer because of frame rounding. | 0.71 ≤ n ≤ 15 · default: 5 |
| seed | integer | Seed for the continuation. Random when omitted. | nullable |
| enable_safety_checker | boolean | Moderate the source video and the prompt. | default: true |
| resolution | enum | Output video resolution. | 480P | 768P | 1080P | 2K · default: "768P" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"minimax/h3-max/extend-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}