GET
/v1/schemas/fal/video/fal-ai%2Fauto-caption
Accept:
Request body
9 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| video_url* | string | URL to the .mp4 video with audio. Only videos of size <400MB are allowed. | |
| left_align | string | number | Left-to-right alignment of the text. Can be a string ('left', 'center', 'right') or a float (0.0-1.0) | default: "center" |
| top_align | string | number | Top-to-bottom alignment of the text. Can be a string ('top', 'center', 'bottom') or a float (0.0-1.0) | default: "center" |
| txt_font | string | Font for generated captions. Choose one in 'Arial','Standard','Garamond', 'Times New Roman','Georgia', or pass a url to a .ttf file | default: "Standard" |
| refresh_interval | number | Number of seconds the captions should stay on screen. A higher number will also result in more text being displayed at once. | 0.5 ≤ n ≤ 3 · default: 1.5 |
| stroke_width | integer | Width of the text strokes in pixels | default: 1 |
| font_size | integer | Size of text in generated captions. | default: 24 |
| txt_color | string | Colour of the text. Can be a RGB tuple, a color name, or an hexadecimal notation. | default: "white" |
| text_case | enum | Capitalization to apply to subtitle text. 'upper' converts text to UPPERCASE, 'lower' converts to lowercase, and 'default' preserves the original casing produced by the speech recognizer. | default | upper | lower · default: "default" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/auto-caption","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}